Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "metadata": {},
  "provider_slug": "<string>",
  "token": "<string>",
  "verification_url": "<string>"
}

{
  "id": "<string>",
  "metadata": {},
  "provider_slug": "<string>",
  "token": "<string>",
  "verification_url": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Start an authorization session

Initiates an OAuth flow for the caller. strategy is optional and defaults to REUSE (return an existing token when scopes match); use CREATE to force a new OAuth flow. Status values: COMPLETED — a valid token is available and the response includes token (HTTP 200); PENDING — the user must visit verification_url to authorize (HTTP 201, includes session id and Location header); CONNECTION_REQUIRED — no usable token or connection exists for the provider; TOKEN_EXPIRED — the stored token expired and cannot be refreshed, re-authorize. is_default defaults to true; set false when adding a secondary account with strategy CREATE. token_id targets a specific stored token in multi-account flows.

POST

fleet

auth-sessions

Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "metadata": {},
  "provider_slug": "<string>",
  "token": "<string>",
  "verification_url": "<string>"
}

{
  "id": "<string>",
  "metadata": {},
  "provider_slug": "<string>",
  "token": "<string>",
  "verification_url": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Body

application/json

Session details

is_default

boolean

Defaults to true. When adding a secondary account (strategy: CREATE), set false.

provider_slug

string

redirect_uri

string

Custom OAuth callback URL for headless flows. Must be a member of the provider's allowed_redirect_uris allowlist (enforced by host-backend); forwarded as-is.

scopes

string[]

strategy

enum<string>

Available options:

REUSE,

CREATE

token_id

string

Target a specific stored token in multi-account flows; must belong to the caller.

Response

Existing token reused; no new session created.

string

metadata

object

Show child attributes

provider_slug

string

status

enum<string>

Available options:

PENDING,

COMPLETED,

CONNECTION_REQUIRED,

TOKEN_EXPIRED

token

string

verification_url

string

Update an OAuth provider

Get an authorization session