diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 3177c4f..681d8ee 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -11503,6 +11503,78 @@ paths: ticket_attributes: _default_title_: example _default_description_: there is a problem + "/tickets/enqueue": + post: + summary: Enqueues ticket creation and returns the enqueue status. We recommend using this endpoint if you'd like to create tickets without waiting for immediate processing. + parameters: + - name: Intercom-Version + in: header + schema: + "$ref": "#/components/schemas/intercom_version" + tags: + - Tickets + description: You can enqueue a job to create a new ticket. + operationId: enqueueCreateTicket + responses: + '200': + description: Successful response + content: + application/json: + examples: + Successful response: + value: + type: enqueue_status + status: success + job_id: 20 + job_url: https://api.intercom.io/jobs/status/20 + schema: + "$ref": "#/components/schemas/enqueue_status" + '401': + description: Unauthorized + content: + application/json: + examples: + Unauthorized: + value: + type: error.list + request_id: c7bf358f-135e-48d7-8286-a4988a8a1d9b + errors: + - code: unauthorized + message: Access Token Invalid + schema: + "$ref": "#/components/schemas/error" + '400': + description: Bad Request + content: + application/json: + examples: + Bad Request: + value: + type: error.list + request_id: c7bf358f-135e-48d7-8286-a4988a8a1456 + errors: + - code: parameter_invalid + message: "Missing required ticket }/attributes" + schema: + "$ref": "#/components/schemas/error" + requestBody: + content: + application/json: + schema: + allOf: + - "$ref": "#/components/schemas/create_ticket_request" + properties: + skip_notifications: + type: boolean + description: Option to disable notifications when a Ticket is created. + example: true + examples: + successful_response: + summary: Successful response + value: + status: success + job_id: 20 + job_url: https://api.intercom.io/jobs/status/20 "/tickets/{id}": put: summary: Update a ticket @@ -16232,11 +16304,16 @@ components: assignment: type: object properties: - assignee_id: + admin_assignee_id: type: string description: The ID of the admin to which the ticket is assigned. If not provided, the ticket will be unassigned. example: '123' + team_assignee_id: + type: string + description: The ID of the team to which the ticket is assigned. + If not provided, the ticket will be unassigned. + example: '8' required: - ticket_type_id - contacts @@ -17147,6 +17224,33 @@ components: required: - type - errors + enqueue_status: + title: Enqueue Status + type: enqueue_status + description: Status of the enqueued job. + properties: + type: + type: string + description: Always enqueue_status + enum: + - enqueue_status + default: enqueue_status + example: enqueue_status + status: + type: string + description: Result of the enqueue + enum: + - success + - failed + example: success + job_id: + type: string + description: Id of the job that was created. Note this is not the id of the resource being created (i.e. ticket) + example: 20 + job_url: + type: string + description: Url of the job that was created. This url should be used to fetch the status of the job. + example: https://api.intercom.io/jobs/status/20 external_page: title: External Page type: object