{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/immersa/main/json-schema/immersa-post-api-v1-connection-setup-sessions-response-schema.json", "title": "PostApiV1ConnectionSetupSessionsResponse", "x-generated": "2026-10-18", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/_ae-authored/immersa-openapi-generated.yml#/components/schemas/PostApiV1ConnectionSetupSessionsResponse", "type": "object", "properties": { "setup_session_id": { "type": "string", "description": "Unguessable, user‑scoped identifier for the setup session." }, "status": { "type": "string", "description": "Literal \"pending\" while the flow is in progress." }, "connection_type": { "type": "string", "description": "The connection type being set up." }, "connection_name": { "type": "string", "description": "Name the connection will have once ready." }, "display_name": { "type": "string", "description": "Human‑readable name supplied in the request." }, "return_url": { "type": "string", "description": "The return URL if one was provided." }, "created_at": { "type": "string", "description": "Timestamp when the session was created." }, "expires_at": { "type": "string", "description": "Timestamp when the session expires (15 minutes after last change)." }, "failure": { "type": "object", "description": "Object with code and message set only if the session fails." }, "authorization_url": { "type": "string", "description": "URL to open in the user’s browser to complete the OAuth flow (present in the start response)." } } }