> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cconnect.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a ticket

> Partially updates status, priority, assignee, group or custom fields. assignee_id must belong to your company; an empty string removes the assignee. Custom fields are merged; an empty value clears an optional field.

Required scope: `tickets:write`. Required product: `desk`.



## OpenAPI

````yaml /openapi.json patch /api/v1/tickets/{id}
openapi: 3.0.1
info:
  title: Cconnect Customer API
  description: >-
    Company-scoped REST API for Cconnect Desk and Chat. Bearer credentials are
    issued by your company administrator. Public documentation does not grant
    data access. Operations require CustomerApi:Enabled on the API deployment.
  contact:
    name: Cconnect
    url: https://cconnect.online
  version: 1.1.0
servers:
  - url: https://cconnect.online
    description: Cconnect API server (separate from developers.cconnect.online)
security:
  - CustomerBearer: []
externalDocs:
  description: Cconnect developer portal
  url: https://developers.cconnect.online
paths:
  /api/v1/tickets/{id}:
    patch:
      tags:
        - Tickets
      summary: Update a ticket
      description: >-
        Partially updates status, priority, assignee, group or custom fields.
        assignee_id must belong to your company; an empty string removes the
        assignee. Custom fields are merged; an empty value clears an optional
        field.


        Required scope: `tickets:write`. Required product: `desk`.
      operationId: UpdateTicket
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiUpdateTicketRequest'
            example:
              status: pending
              priority: high
        required: true
      responses:
        '200':
          description: OK
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTicketApiData'
        '400':
          description: Bad Request
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Unauthorized
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '403':
          description: Forbidden
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '413':
          description: Content Too Large
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '429':
          description: Too Many Requests
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            Retry-After:
              description: Seconds until a retry is allowed.
              schema:
                type: integer
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '503':
          description: Service Unavailable
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
            X-RateLimit-Limit:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Remaining:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
            X-RateLimit-Reset:
              description: >-
                Company quota metadata (reset is Unix seconds). Present after
                bearer authentication and company subscription validation.
              schema:
                type: integer
                format: int64
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ApiUpdateTicketRequest:
      type: object
      properties:
        status:
          pattern: ^(open|pending|resolved|closed)$
          type: string
          nullable: true
        priority:
          pattern: ^(low|normal|high|urgent)$
          type: string
          nullable: true
        assignee_id:
          maxLength: 36
          minLength: 0
          type: string
          nullable: true
        group_name:
          maxLength: 100
          minLength: 1
          type: string
          nullable: true
        custom_fields:
          type: object
          additionalProperties:
            type: string
          nullable: true
      additionalProperties: false
    ApiTicketApiData:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ApiTicket'
      additionalProperties: false
    ApiErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ApiError'
        request_id:
          type: string
      additionalProperties: false
    ApiTicket:
      type: object
      properties:
        id:
          type: string
          format: uuid
        number:
          type: string
        subject:
          type: string
        description:
          type: string
        status:
          type: string
        priority:
          type: string
        channel:
          type: string
        conversation_id:
          type: string
          nullable: true
        assignee_id:
          type: string
          nullable: true
        group_name:
          type: string
        custom_fields:
          type: object
          additionalProperties:
            type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      additionalProperties: false
    ApiError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        field:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    CustomerBearer:
      type: http
      description: >-
        Company-owned API token. Supply Authorization: Bearer
        YOUR_CCONNECT_API_TOKEN. Never use provider tokens or member passwords.
        Tokens are shown only once when created.
      scheme: bearer
      bearerFormat: Cconnect API token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.