Tickets

Update a ticket

Applies a partial update to an existing ticket. linkedChatIds replaces the full linked-chat set, and customFields behaves as a partial patch.

patch/v1/tickets/{ticket_id}

Request

  • Base URL: https://api.entergram.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.entergram.com/v1/tickets/{ticket_id}
  • Auth: API key in header X-API-Key

Path parameters

ticket_idstring required

Ticket identifier.

Example:ticket_demo_123

Request body

assignedToIdstring

Updated assignee. Send an empty string to unassign.

commentstring

Updated short note. Send an empty string to clear it.

customFieldsobject

Partial custom-field patch keyed by columnKey. Null or empty-string values delete a field.

datestring date-time

Updated RFC3339 timestamp. Send an empty string to clear it.

descriptionstring

Updated description. Send an empty string to clear it.

linkedChatIdsstring[]

Full replacement of linked Telegram chat ids. Send an empty array to unlink all chats.

prioritystring

Updated priority.

statusstring

Updated status. Setting any non-CLOSED value clears closedAt/closedBy.

titlestring

Updated title. Empty string is rejected.

Example request

{
  "assignedToId": "user_demo_123",
  "comment": "Waiting for sample approval",
  "date": "2026-04-02T09:30:00Z",
  "description": "Synthetic customer moved the follow-up to Friday.",
  "priority": "LOW",
  "status": "IN_PROGRESS",
  "title": "Confirm onboarding checklist"
}

Response

OK

Example response

{
  "data": {
    "assignedTo": {
      "displayName": "Alex Example",
      "email": "alex@example.test",
      "id": "user_demo_123"
    },
    "attachmentCount": 1,
    "closedBy": {
      "displayName": "Alex Example",
      "email": "alex@example.test",
      "id": "user_demo_123"
    },
    "comment": "Sample escalation note",
    "commentCount": 3,
    "createdBy": {
      "displayName": "Alex Example",
      "email": "alex@example.test",
      "id": "user_demo_123"
    },
    "customFields": [
      {
        "columnKey": "source_campaign"
      }
    ],
    "description": "Synthetic customer asked for a follow-up next week.",
    "displayId": "#42",
    "id": "ticket_demo_123",
    "legacyTicketHash": "#TKT-001",
    "priority": "HIGH",
    "status": "OPEN",
    "ticketHash": "#42",
    "ticketNumber": 42,
    "title": "Review onboarding request",
    "userId": "user_demo_123",
    "workspaceId": "workspace_demo_123"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.