Update Ticket

PATCH

/public/v1/tickets/{ticket_id}

curl --request PATCH \
  --url https://api.aymaragents.com/public/v1/tickets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "status": "open", "assignedTo": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "subject": "example" }'

• Producción

Partially update status/assignedTo/subject (SPEC_API_PUBLICA.md §2.5).

Unknown/foreign ticketId -> 404, zero changes. A NEW assignedTo must resolve to an assignable tenant user -> 404 otherwise, zero persistence.

---

Permiso necesario: tenant:tickets.manage

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

ticket_id

required

Ticket Id

string format: uuid

Request Body^required

Media typeapplication/json

PublicUpdateTicketRequest

PATCH /public/v1/tickets/{id} body – all fields optional (partial update).

object

status

Any of:

string

string

Allowed values: open in_progress closed

null

null

assignedTo

Any of:

string

string format: uuid

null

null

subject

Any of:

string

string

>= 1 characters <= 500 characters

null

null

Responses

200

Successful Response

Media typeapplication/json

PublicTicketOut

A single ticket with its embedded comment thread – same shape as the internal TicketOut (nothing curated away: every field here is already an id/status/text a third party legitimately needs to track its own ticket).

object

id

required

Id

string

customerId

Any of:

string

string

null

null

leadId

Any of:

string

string

null

null

conversationId

Any of:

string

string

null

null

subject

required

Subject

string

status

required

Status

string

createdBy

required

Createdby

string

assignedTo

Any of:

string

string

null

null

createdAt

required

Createdat

string

updatedAt

required

Updatedat

string

comments

Comments

Array<object>

PublicTicketCommentOut

One comment in a ticket’s thread – same shape as the internal TicketCommentOut.

object

id

required

Id

string

authorUserId

required

Authoruserid

string

body

required

Body

string

createdAt

required

Createdat

string

Example^generated

{
  "id": "example",
  "customerId": "example",
  "leadId": "example",
  "conversationId": "example",
  "subject": "example",
  "status": "example",
  "createdBy": "example",
  "assignedTo": "example",
  "createdAt": "example",
  "updatedAt": "example",
  "comments": [
    {
      "id": "example",
      "authorUserId": "example",
      "body": "example",
      "createdAt": "example"
    }
  ]
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}