Inspect an owned provider presentation attempt

Reads one content-free presentation attempt only when the caller presents its exact server-minted owner capability and generation. Hosts use this after restart to distinguish pre-dispatch work, dispatching ambiguity, and terminal settlement without issuing another provider effect.

Checkfu support posture: alpha; hosted. Required evidence journey: collaboration-identity. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

POST /v1/conversation-presentations/inspect

Inspect an owned provider presentation attempt

cURL

curl --request POST \
  --url https://api.checkfu.com/v1/conversation-presentations/inspect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --data '
{
  "external_installation_id": "<string>",
  "key": {
    "conversation_binding_id": "<string>",
    "session_id": "<string>",
    "interaction_id": "<string>",
    "revision": "<string>",
    "delivery_role": "<string>"
  },
  "generation": 1,
  "owner": "<string>"
}
'

200

{
  "key": {
    "conversation_binding_id": "<string>",
    "session_id": "<string>",
    "interaction_id": "<string>",
    "kind": "input_accounting",
    "revision": "<string>",
    "delivery_role": "<string>"
  },
  "generation": 1,
  "owner": "<string>",
  "lease_expires_at": "<string>",
  "state": "claimed",
  "through_sequence": 1,
  "provider_message_id": "<string>",
  "claimed_at": "<string>",
  "dispatch_started_at": "<string>",
  "settled_at": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version · enum<string> · required

Available options: 2026-08-29

idempotency-key · string

Maximum string length: 255

Body

application/json

external_installation_id · string · required

Pattern: ^exti_[0-9a-f]{32}$

key · object · required

Show child attributes

generation · integer · required

Required range: x > 0

owner · string · required

Required string length: 1 - 128

Response

200

application/json

Success

key · object · required

Show child attributes

generation · integer · required

Required range: x > 0

owner · string | null · required

Required string length: 1 - 128

lease_expires_at · string | null · required

A retained UTC timestamp using the historical zero-to-three fractional-digit encoding.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$

state · enum<string> · required

Available options: claimed, dispatching, posted, known_failed, indeterminate, superseded

through_sequence · integer · required

Required range: x >= 0

provider_message_id · string | null · required

claimed_at · string · required

A retained UTC timestamp using the historical zero-to-three fractional-digit encoding.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$

dispatch_started_at · string | null · required

A retained UTC timestamp using the historical zero-to-three fractional-digit encoding.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$

settled_at · string | null · required

A retained UTC timestamp using the historical zero-to-three fractional-digit encoding.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$