Operation

Edit customer note

PATCH/customers/{customerId}/notes/{noteId}

Change a note's body or tier. Its author only (403 NOTE_AUTHOR_ONLY), who must still be allowed to update the customer and to write both tiers. The note that stands for a field keeps that field's tier.

Path parameters

customerIdstringRequired: Customer ID
noteIdstringRequired: Note ID

Headers

Idempotency-KeystringOptional: Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

Returns

Note updated

Errors

400: Bad Request - Invalid input
401: Unauthorized - Authentication required
403: Forbidden - Insufficient permissions
404: Not Found - Resource not found
500: Internal Server Error

Every error names its code and links to it. All error codes

curl -X PATCH "https://api.ticketlayer.com/v1/customers/cus_abc123/notes/nte_abc123def456ghi789jk" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug" \  -H "Content-Type: application/json" \  -d '{    "body": "Comp for the promoter, agreed by Sam.",    "tier": "restricted"  }'

Response 200

{
  "note": {
    "id": "nte_abc123def456ghi789jk",
    "objectType": "order",
    "objectId": "ord_abc123xyz789",
    "tier": "internal",
    "body": "Customer called: wants the seats moved to the aisle.",
    "author": {
      "kind": "user",
      "id": "usr_abc123"
    },
    "legacyField": null,
    "createdAt": "2026-10-02T10:30:00.000Z",
    "editedAt": null,
    "deletedAt": null,
    "redactedAt": null
  }
}

Edit customer note

Path parameters

Headers

Body

Returns

Errors

Try it in test mode

Path parameters