HardTickets

Start working on a hard ticket

Work on the ticket: Kai Support works on it (Kai Code Cloud, a Bridge machine) or it opens in an app on your computer. One active session per ticket: a second start returns the running one (alreadyRunning). Apps get kickoff for the deeplink (AgentHandoff.ts); no report within 3 minutes reads "Not connected".

POST

https://api.gleap.io/v3/hard-tickets/tickets/{ticketId}/start

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Path parameters

ticketIdstringrequired

Headers

projectstringrequired

Bodyapplication/jsonrequired

runnerobjectrequired

Any of

kindenum<string>required

Allowed values: cloud

deviceIdstringrequired

kindenum<string>required

Allowed values: bridge

appenum<string>required

Allowed values: claude_codecodexcursorantigravity

kindenum<string>required

Allowed values: app

Response

application/json

Updated November 3, 2026

curl --request POST \
  --url 'https://api.gleap.io/v3/hard-tickets/tickets/{ticketId}/start' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>' \
  --header 'Content-Type: application/json' \
  --data '{
  "runner": {
    "kind": "cloud"
  }
}'

No example in the spec.