|
275 | 275 | ] |
276 | 276 | } |
277 | 277 | }, |
| 278 | + "/analytics/resolution/{domain}": { |
| 279 | + "get": { |
| 280 | + "tags": [ |
| 281 | + "Analytics" |
| 282 | + ], |
| 283 | + "summary": "Get Conversation Resolution", |
| 284 | + "description": "Get conversation resolution metrics for a domain in a given time period.", |
| 285 | + "operationId": "get_conversation_resolution", |
| 286 | + "parameters": [ |
| 287 | + { |
| 288 | + "name": "domain", |
| 289 | + "in": "path", |
| 290 | + "required": true, |
| 291 | + "schema": { |
| 292 | + "type": "string", |
| 293 | + "title": "Domain" |
| 294 | + } |
| 295 | + }, |
| 296 | + { |
| 297 | + "name": "start_date", |
| 298 | + "in": "query", |
| 299 | + "required": false, |
| 300 | + "schema": { |
| 301 | + "anyOf": [ |
| 302 | + { |
| 303 | + "type": "string", |
| 304 | + "format": "date-time" |
| 305 | + }, |
| 306 | + { |
| 307 | + "type": "null" |
| 308 | + } |
| 309 | + ], |
| 310 | + "description": "The start date of the period to retrieve resolution metrics for", |
| 311 | + "title": "Start Date" |
| 312 | + }, |
| 313 | + "description": "The start date of the period to retrieve resolution metrics for" |
| 314 | + }, |
| 315 | + { |
| 316 | + "name": "end_date", |
| 317 | + "in": "query", |
| 318 | + "required": false, |
| 319 | + "schema": { |
| 320 | + "anyOf": [ |
| 321 | + { |
| 322 | + "type": "string", |
| 323 | + "format": "date-time" |
| 324 | + }, |
| 325 | + { |
| 326 | + "type": "null" |
| 327 | + } |
| 328 | + ], |
| 329 | + "description": "The end date of the period to retrieve resolution metrics for", |
| 330 | + "title": "End Date" |
| 331 | + }, |
| 332 | + "description": "The end date of the period to retrieve resolution metrics for" |
| 333 | + } |
| 334 | + ], |
| 335 | + "responses": { |
| 336 | + "200": { |
| 337 | + "description": "Successful Response", |
| 338 | + "content": { |
| 339 | + "application/json": { |
| 340 | + "schema": { |
| 341 | + "$ref": "#/components/schemas/GetConversationResolutionResponse" |
| 342 | + } |
| 343 | + } |
| 344 | + } |
| 345 | + }, |
| 346 | + "422": { |
| 347 | + "description": "Validation Error", |
| 348 | + "content": { |
| 349 | + "application/json": { |
| 350 | + "schema": { |
| 351 | + "$ref": "#/components/schemas/HTTPValidationError" |
| 352 | + } |
| 353 | + } |
| 354 | + } |
| 355 | + } |
| 356 | + }, |
| 357 | + "x-fern-audiences": [ |
| 358 | + "internal" |
| 359 | + ], |
| 360 | + "security": [ |
| 361 | + { |
| 362 | + "bearerAuth": [] |
| 363 | + } |
| 364 | + ] |
| 365 | + } |
| 366 | + }, |
278 | 367 | "/chat/{domain}": { |
279 | 368 | "post": { |
280 | 369 | "tags": [ |
|
2136 | 2225 | "Settings" |
2137 | 2226 | ], |
2138 | 2227 | "summary": "Toggle Ask Ai", |
2139 | | - "description": "Toggle Ask AI setting and return job_id for tracking.", |
| 2228 | + "description": "Toggle Ask AI setting and return job_id for tracking.\n\nArgs:\n domain: Domain to toggle Ask AI for\n org_name: Organization name\n preview: Whether this is a preview deployment\n locations: Optional list of locations to enable. Valid values: docs, slack, discord", |
2140 | 2229 | "operationId": "toggle_ask_ai", |
2141 | 2230 | "parameters": [ |
2142 | 2231 | { |
|
2166 | 2255 | "default": false, |
2167 | 2256 | "title": "Preview" |
2168 | 2257 | } |
| 2258 | + }, |
| 2259 | + { |
| 2260 | + "name": "locations", |
| 2261 | + "in": "query", |
| 2262 | + "required": false, |
| 2263 | + "schema": { |
| 2264 | + "anyOf": [ |
| 2265 | + { |
| 2266 | + "type": "array", |
| 2267 | + "items": { |
| 2268 | + "enum": [ |
| 2269 | + "docs", |
| 2270 | + "slack", |
| 2271 | + "discord" |
| 2272 | + ], |
| 2273 | + "type": "string" |
| 2274 | + } |
| 2275 | + }, |
| 2276 | + { |
| 2277 | + "type": "null" |
| 2278 | + } |
| 2279 | + ], |
| 2280 | + "title": "Locations" |
| 2281 | + } |
2169 | 2282 | } |
2170 | 2283 | ], |
2171 | 2284 | "responses": { |
|
3238 | 3351 | ], |
3239 | 3352 | "title": "Feedback" |
3240 | 3353 | }, |
| 3354 | + "GetConversationResolutionResponse": { |
| 3355 | + "properties": { |
| 3356 | + "total_conversations": { |
| 3357 | + "type": "integer", |
| 3358 | + "title": "Total Conversations", |
| 3359 | + "description": "Total number of conversations in the period" |
| 3360 | + }, |
| 3361 | + "resolved_conversations": { |
| 3362 | + "type": "integer", |
| 3363 | + "title": "Resolved Conversations", |
| 3364 | + "description": "Number of resolved conversations" |
| 3365 | + }, |
| 3366 | + "unresolved_conversations": { |
| 3367 | + "type": "integer", |
| 3368 | + "title": "Unresolved Conversations", |
| 3369 | + "description": "Number of unresolved conversations" |
| 3370 | + }, |
| 3371 | + "resolution_rate": { |
| 3372 | + "type": "number", |
| 3373 | + "title": "Resolution Rate", |
| 3374 | + "description": "Percentage of conversations resolved (0-100)" |
| 3375 | + } |
| 3376 | + }, |
| 3377 | + "type": "object", |
| 3378 | + "required": [ |
| 3379 | + "total_conversations", |
| 3380 | + "resolved_conversations", |
| 3381 | + "unresolved_conversations", |
| 3382 | + "resolution_rate" |
| 3383 | + ], |
| 3384 | + "title": "GetConversationResolutionResponse" |
| 3385 | + }, |
3241 | 3386 | "GetConversationResponse": { |
3242 | 3387 | "properties": { |
3243 | 3388 | "conversation": { |
|
0 commit comments