Get an authorization session

Return the current status of an in-flight authorization session. Use wait_seconds to long-poll until the session completes or the wait window expires.

GET /auth-sessions/{session_id}

Get an authorization session

cURL

curl --request GET \
  --url https://api.smith.langchain.com/v1/deepagents/auth-sessions/{session_id} \
  --header 'X-Api-Key: <api-key>'

200

Example

{ "id": "<string>" }

Authorizations

X-Api-Key · string · header · default: LANGSMITH_API_KEY · required

Path Parameters

session_id · string · required

Authorization session ID.

Query Parameters

wait_seconds · integer · default: 1

Long-poll window in seconds. Defaults to 1. Maximum is 25.

Required range: 1 <= x <= 25

Response

200

application/json

Authorization session status returned.

id · string

status · enum<string>

Current authorization session status.

Available options: PENDING, COMPLETED, CONNECTION_REQUIRED, TOKEN_EXPIRED