Add Ticket Comment

POST

/public/v1/tickets/{ticket_id}/comments

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

• Producción

Add a comment to a ticket’s thread, authored by the KEY OWNER (SPEC_API_PUBLICA.md §2.5).

Unknown/foreign ticketId -> 404, zero persistence. Valid on a closed ticket (never reopens it). Returns the full, refreshed PublicTicketOut.

---

Permiso necesario: tenant:tickets.manage

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

ticket_id

required

Ticket Id

string format: uuid

Request Body^required

Media typeapplication/json

PublicAddTicketCommentRequest

POST /public/v1/tickets/{id}/comments body.

object

body

required

Body

string

>= 1 characters

Example^generated

{
  "body": "example"
}

Responses

201

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": {}
    }
  ]
}