Error Codes

All API errors across Passage Connect and Passage Platform follow a consistent format.

Error response format


{
  "error": {
    "code": "not_found",
    "message": "Link not found"
  }
}

Code	HTTP Status	Description
`unauthorized`	401	Missing or invalid API key
`forbidden`	403	API key does not have access to this resource
`not_found`	404	Resource not found
`validation_error`	400	Invalid request body or parameters
`conflict`	409	Resource state conflict (e.g., re-claiming a completed link)
`internal_error`	500	Unexpected server error

Code	Description
`session_expired`	Session has timed out
`session_terminal`	Session is in a terminal state (complete/failed/expired)
`command_pending`	A command is already in flight