Connect ChatGPT

/api/v1/owner/providers/chatgpt/loginPOST

Starts the local callback listener and browser authorization flow. Optional accountId selects a previously registered account. Open the returned URL.

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

accountId?string

Response

200 · Successful response. A paused run is an application outcome, not an HTTP error.

url *string

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/login" \
  -H "x-halfspan-owner: 1" \
  -b "halfspan_session=<token>" \
  -H "Content-Type: application/json" \
  -d '{}'

Response example

{
  "url": "https://auth.openai.com/oauth/authorize?<browser-bound-parameters>"
}