Skip to Content
CallMitraDocs
API referenceTickets

Add a note to a ticket

A note your team sees on the ticket; the customer does not. Optionally moves the ticket's status.

POST
/api/v1/tickets/{ticket_id}/activities

A note your team sees on the ticket; the customer does not. Optionally moves the ticket's status.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

ticket_id*Ticket Id

Ticket id.

Header Parameters

Idempotency-Key?string

Any unique string up to 255 characters. Retrying with the same key and body within 24 hours returns the first result instead of acting twice.

Lengthlength <= 255

Request Body

application/json
  1. body

A private team note, never sent to the customer; a note may be just attachments.

attachmentIds?array<string>

Files already uploaded to the ticket (console only).

Itemsitems <= 5
note?Note

Note text, visible to your team only.

Lengthlength <= 8000
Default""
status?|

Also move the ticket to this status: open, in_progress, waiting_on_customer, resolved or closed.

version?|

The version you last read; if the ticket changed since, the request fails with 409. Leave out to skip.

Response Body

OK

application/json
  1. response
activities*array<>

Only the activities this request added.

changed*array<string>

Fields that changed (activities when a note or reply was added).

success*Success

Always true on a 2xx response.

ticket*

The ticket after the change.

[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/tickets/string/activities' \  -H 'Content-Type: application/json' \  -d '{  "note": "Courier confirmed the parcel is at the local hub; asked them to redeliver tomorrow.",  "status": "waiting_on_customer",  "version": 2}'
Example Response
{  "activities": [    {      "activityType": "status_change",      "actorName": "Priya Nair",      "actorUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",      "createdAt": "2026-01-15T11:20:00+00:00",      "id": "5f6a7b8c-9d0e-4f1a-9b2c-4d5e6f7a8b9d",      "payload": {        "from": "in_progress",        "source": "console",        "to": "waiting_on_customer"      },      "ticketId": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90"    },    {      "activityType": "comment",      "actorName": "Priya Nair",      "actorUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",      "createdAt": "2026-01-15T11:20:00+00:00",      "id": "3d4e5f6a-7b8c-4d9e-9f0a-2b3c4d5e6f7a",      "payload": {        "note": "Courier confirmed the parcel is at the local hub; asked them to redeliver tomorrow."      },      "ticketId": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90"    }  ],  "changed": [    "status",    "activities"  ],  "success": true,  "ticket": {    "activityCount": 5,    "assignedToUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",    "assigneeEmail": "[email protected]",    "assigneeName": "Priya Nair",    "assigneeNames": [      "Priya Nair"    ],    "assignees": [      {        "assignedAt": "2026-01-15T09:30:02+00:00",        "email": "[email protected]",        "name": "Priya Nair",        "userId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f"      }    ],    "canEdit": true,    "canManageAssignees": true,    "canReopenClosed": false,    "categoryId": "3b9f1d7e-6c2a-4e85-a0d4-7f1e2c3b4a56",    "categoryName": "Delivery",    "createdAt": "2026-01-15T09:30:00+00:00",    "createdByUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",    "description": "Customer says the parcel was marked delivered but never arrived.",    "dueAt": "2026-01-16T09:30:00+00:00",    "id": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90",    "leadId": "a41e7c2d-8f35-4b09-b6d2-93c0e5f1a7b8",    "leadName": "Asha Verma",    "leadPhone": "+919812345678",    "merchantId": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a",    "overdue": false,    "priority": "high",    "ref": "T-5F0C9A3E",    "sla": {      "firstResponse": {        "dueAt": "2026-01-15T13:30:00+00:00",        "state": "ok",        "warnAt": "2026-01-15T12:30:00+00:00"      },      "paused": false,      "resolution": {        "dueAt": "2026-01-16T09:30:00+00:00",        "state": "ok",        "warnAt": "2026-01-16T05:30:00+00:00"      }    },    "source": "manual",    "status": "waiting_on_customer",    "subject": "Order #1042 not delivered",    "tags": [      "order-1042"    ],    "teamId": "e7a1c3d5-9b2f-4d68-8a0c-2e4f6a8b0c1d",    "teamName": "Customer care",    "type": "support",    "updatedAt": "2026-01-15T11:20:00+00:00",    "version": 3  }}