Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Select a ChatGPT model

/api/v1/owner/providers/chatgpt/modelPOST
Validates the model against the connected account before saving.
Examples are synthetic and illustrate response shape; IDs, signatures, and credentials are not usable authority.
Authorization
ownerSession *cookie halfspan_session
Authenticated HttpOnly owner session. Not an executor credential.
Request Bodyapplication/jsonrequired
model *string
Min length: 1
Response
200 · Successful response. A paused run is an application outcome, not an HTTP error.
connected *boolean
ready *boolean
model *string
active?string
pending *boolean
message *string
accounts *object[]
Show item properties
id *string
email?string
connected *boolean
400 · Request validation failed.
error *string
reasonCode?string
401 · Sign in to the Halfspan workspace.
error *string
reasonCode?string
403 · Console requests must come from the local owner workspace.
error *string
reasonCode?string
500 · The local service could not complete this request.
error *string
reasonCode?string
Request example
curl -X POST "https://service.example.com/api/v1/owner/providers/chatgpt/model" \ -H "x-halfspan-owner: 1" \ -b "halfspan_session=<token>" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.4" }'
Response example
{ "connected": true, "ready": true, "model": "gpt-5.4", "pending": false, "message": "", "accounts": [] }