Tickets

Update a ticket

Updates a ticket's properties. Only provided fields will be updated.

PATCH

/v2/tickets/{id}

Update a ticket

curl --request PATCH \
  --url https://do.featurebase.app/v2/tickets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assigneeId": "507f1f77bcf86cd799439013",
  "companyId": "507f1f77bcf86cd799439015",
  "content": "<p>Updated description.</p>",
  "customFields": {},
  "open": false,
  "skipNotifications": false,
  "snoozedUntil": "2025-01-16T09:00:00.000Z",
  "statusId": "507f1f77bcf86cd799439016",
  "title": "Updated ticket title"
}
'

{
  "assigneeId": "507f1f77bcf86cd799439013",
  "author": {
    "email": "john@example.com",
    "id": "507f1f77bcf86cd799439011",
    "name": "John Doe",
    "profilePicture": "https://cdn.example.com/avatars/john.png",
    "type": "customer"
  },
  "categoryType": "customer",
  "companyId": "507f1f77bcf86cd799439015",
  "content": "<p>I get a 403 error when logging in.</p>",
  "conversationParts": [
    {
      "author": {
        "email": "john@example.com",
        "id": "676f0f6765bdaa7d7d760f88",
        "name": "John Doe",
        "profilePicture": "https://cdn.example.com/avatars/user.png",
        "type": "customer"
      },
      "bodyHtml": "<p>Hello, I have a question about your product.</p>",
      "bodyMarkdown": "Hello, I have a question about your product.",
      "channel": "desktop",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "id": "1",
      "object": "conversation_part",
      "partType": "user_msg",
      "redacted": false,
      "slack": {
        "channelId": "C01EFGH",
        "messageTs": "1705313410.001200",
        "teamId": "T01ABCD",
        "threadTs": "1705313400.001100"
      },
      "tagApplications": [
        {
          "appliedAt": "2025-01-15T10:30:00.000Z",
          "appliedBy": {
            "id": "507f1f77bcf86cd799439011",
            "name": "John Doe",
            "type": "admin"
          },
          "removedAt": "2025-01-15T11:00:00.000Z",
          "removedBy": {
            "id": "507f1f77bcf86cd799439011",
            "name": "John Doe",
            "type": "admin"
          },
          "tag": {
            "id": "67ec1234abcd5678ef901234",
            "name": "Churn",
            "type": "tag"
          },
          "tagId": "67ec1234abcd5678ef901234"
        }
      ],
      "updatedAt": "2025-01-15T10:30:00.000Z"
    }
  ],
  "createdAt": "2025-01-15T10:30:00.000Z",
  "customFields": {
    "507f1f77bcf86cd799439099": "{\"key\":\"org/pending/file.pdf\",\"name\":\"document.pdf\",\"url\":\"https://...\"}",
    "priority": "high"
  },
  "id": "507f1f77bcf86cd799439011",
  "integrations": {
    "clickup": [
      {
        "id": "86a1b2c3d",
        "title": "Fix login bug",
        "url": "https://app.clickup.com/t/86a1b2c3d"
      }
    ],
    "devops": [
      {
        "id": 789,
        "projectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "projectName": "My Project",
        "title": "Implement SSO",

Path Parameters

id - The ticket number

Request Body

All fields are optional.

Field	Type	Description
`title`	string	Update title
`content`	string	Update description (HTML)
`statusId`	string	Set status by ID
`open`	boolean	Close (false) or reopen (true) the ticket
`assigneeId`	string/null	Assign/unassign admin
`companyId`	string/null	Update company association
`customFields`	object	Update custom field values
`snoozedUntil`	string/null	Snooze until ISO 8601 timestamp (null to unsnooze)
`skipNotifications`	boolean	Skip notifications (default false)

Closing a Ticket

Set open: false to close the ticket. Closing a ticket will also unsnooze it. The status is not changed automatically — use statusId to change the status explicitly.

File Custom Fields

File-type custom fields support the same two upload methods as ticket creation: multipart upload (customFields.<fieldId> file parts with JSON in the data field) and external URLs ({ "url": "https://..." } with optional "name" in the custom field value). Same limits apply (10 files, 400MB total, executable types blocked).

Response

Returns the updated ticket object.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idintegerrequired

Required range: 1 <= x

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Body

assigneeIdstring | null

Example: 507f1f77bcf86cd799439013

companyIdstring | null

Example: 507f1f77bcf86cd799439015

contentstring

Example: <p>Updated description.</p>

customFieldsobject

openboolean

Example: false

skipNotificationsbooleandefault:false

Example: false

snoozedUntilstring | null

Example: 2025-01-16T09:00:00.000Z

statusIdstring

Example: 507f1f77bcf86cd799439016

titlestring

Minimum string length: 2

Example: Updated ticket title

Response

Success

assigneeIdstring | nullrequired

Assigned admin ID

Example: 507f1f77bcf86cd799439013

authorobject | nullrequired

Contact who created the ticket

Show child attributes

categoryTypeenum<string>required

Ticket category type

Available options: customer, tracker, back-office

Example: customer

companyIdstring | nullrequired

Associated company ID

Example: 507f1f77bcf86cd799439015

contentstringrequired

Ticket content/description (HTML)

Example: <p>I get a 403 error when logging in.</p>

conversationPartsobject[]

Conversation message history. Only included when fetching a single ticket by ID.

Show child attributes

createdAtstringrequired

ISO 8601 creation timestamp

Example: 2025-01-15T10:30:00.000Z

customFieldsobjectrequired

Custom field values keyed by field ID. File-type fields contain a JSON string of { key, name, url } with a signed download URL (1 hour expiry). For allowMultiple file fields, the value is a JSON string of an array of these objects.

idstringrequired

Unique identifier (MongoDB ID)

Example: 507f1f77bcf86cd799439011

integrationsobjectrequired

Third-party integration links

Show child attributes

linkedConversationsobject[]required

Linked conversations

Show child attributes

objectenum<string>required

Object type identifier

Available options: ticket

Example: ticket

openbooleanrequired

Whether the ticket is open

Example: true

snoozedUntilstring | nullrequired

ISO 8601 timestamp until snoozed (from linked conversation)

Example: 2025-01-16T09:00:00.000Z

statusobjectrequired

Current ticket status

Show child attributes

teamAssigneeIdstring | nullrequired

Assigned team ID (from linked conversation)

Example: 507f1f77bcf86cd799439014

ticketCategoryIdstringrequired

Ticket category ID

Example: 507f1f77bcf86cd799439011

ticketNumbernumberrequired

Sequential display ID (e.g. TK-42)

Example: 42

ticketUrlstringrequired

Full URL to view the ticket

Example: https://feedback.example.com/p/cannot-login

titlestringrequired

Ticket title

Example: Cannot login to dashboard

updatedAtstringrequired

ISO 8601 last updated timestamp

Example: 2025-01-15T12:30:00.000Z

Still need help? Ask the team