conversations

Handle ticket updates including assignee changes.

put/api/projects/{project_id}/conversations/tickets/{id}/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/conversations/tickets/{id}/
  • Auth: HTTP bearer

Path parameters

idstring required

The ticket's UUID or its numeric ticket number.

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

status'new' | 'open' | 'pending' | 'on_hold' | 'resolved'
  • new - New
  • open - Open
  • pending - Pending
  • on_hold - On hold
  • resolved - Resolved
anonymous_traitsunknown
ai_resolvedboolean

Whether AI resolved the ticket.

escalation_reasonstring nullable

Reason the ticket was escalated. Pass null to clear it.

sla_due_atstring date-time nullable

SLA deadline. Pass null to clear it.

snoozed_untilstring date-time nullable

Time to reopen the ticket. Pass null to reopen it now.

tagsstring[]

Tag names to set on the ticket.

Response

idstring uuid required
ticket_numberinteger required
channel_source'widget' | 'email' | 'slack' | 'teams' | 'github' required
  • widget - Widget
  • email - Email
  • slack - Slack
  • teams - Microsoft Teams
  • github - GitHub
distinct_idstring required
status'new' | 'open' | 'pending' | 'on_hold' | 'resolved'
  • new - New
  • open - Open
  • pending - Pending
  • on_hold - On hold
  • resolved - Resolved
anonymous_traitsunknown
identity_verifiedboolean nullable required

Trust signal indicating whether the ticket's claimed identity was attested by the server (widget HMAC, SPF-authenticated email, or a signature-validated platform webhook). True when verified, false when assessed but not attested, null when unknown (e.g. created before this signal existed).

ai_resolvedboolean
escalation_reasonstring nullable
ai_triageunknown required
created_atstring date-time required
updated_atstring date-time required
message_countinteger required
last_message_atstring date-time nullable required
last_message_textstring nullable required
unread_team_countinteger required
unread_customer_countinteger required
session_idstring nullable required
sla_due_atstring date-time nullable

SLA deadline set via workflows. Null means no SLA.

snoozed_untilstring date-time nullable
slack_channel_idstring nullable required
slack_thread_tsstring nullable required
slack_team_idstring nullable required
email_subjectstring nullable required
email_fromstring email nullable required
email_tostring nullable required
cc_participantsunknown required
github_repostring nullable required
github_issue_numberinteger nullable required
zendesk_ticket_idinteger nullable required
organization_idstring nullable required

Customer's PostHog organization group key, resolved at ticket creation. Null when unknown.

organization_id_sourcestring nullable required

How organization_id was resolved: 'person' (from the requester's identity) or 'slack_channel_account' (inferred from the customer analytics account linked to the ticket's Slack channel). Null when organization_id is unset.

user_access_levelstring nullable required

The effective access level the user has for this object

Changes

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