Core Engine

Ticket Lifecycle & State Machine

Understand the strict finite state machine governing ticket lifecycles, permitted transitions, multi-agent roles, and resolution mechanics.

Ticket Status States

1. Open

Newly created ticket awaiting initial agent triage or response.

2. In Progress

Agent is actively investigating or working on resolution.

3. Pending

Waiting on customer reply, diagnostic logs, or 3rd party vendor.

4. Resolved

Solution delivered. Records resolved_at timestamp.

5. Closed

Finalized and locked. Records closed_at timestamp.

Permitted Status Transitions

From StatusAllowed Target StatesSide Effects & Actions
openin_progress, pending, resolved, closedInitial triage. Direct resolution permitted for quick answers.
in_progresspending, resolved, closedTransitions to pending when awaiting customer input.
pendingin_progress, resolved, closedCustomer replies automatically re-activate ticket to in_progress.
resolvedopen (reopen), closedSets resolved_at; triggers CSAT survey. Reopening clears resolution timestamp.
closedopen (reopen)Sets closed_at. Can only transition back to open via explicit reopen.

Multi-Agent Roles & Collaboration

Tickets support multi-agent assignment to enable seamless cross-department collaboration:

Primary Agent

The main owner responsible for delivering resolution and SLA compliance. Maximum 1 primary agent per ticket.

Collaborator

Specialists (e.g. Database Architect, Tier 3 NetOps) brought in to diagnose or comment via internal notes.

Watcher

Managers, Account Executives, or Auditors receiving real-time event updates and notification alerts.

Updating Ticket Status


PATCH /v1/support/tickets/{id}/statusAuth

Request
PATCH/v1/support/tickets/e4b2d35c-8974-4b53-b09a-6a5a9d821fb1/status
Response

We use cookies and similar technologies to measure traffic and improve the site. You can choose which categories to allow. Manage Preferences.