Discover and register an OAuth provider

{ "allowed_redirect_uris": [ "<string>" ], "auth_url": "https://github.com/login/oauth/authorize", "authorization_params": {}, "client_id": "Iv1.0a1b2c3d4e5f6a7b", "code_challenge_method": "S256", "created_at": "2026-01-15T09:30:00Z", "id": "1a2b3c4d-5e6f-7081-92a3-b4c5d6e7f809", "is_dynamic_client": false, "mcp_server_url": "<string>", "name": "GitHub", "organization_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0", "provider_slug": "github-oauth-provider", "provider_type": "oauth2", "token_endpoint_auth_method": "client_secret_post", "token_url": "https://github.com/login/oauth/access_token", "updated_at": "2026-01-15T09:30:00Z", "uses_pkce": true }

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Body

application/json

MCP server discovery details

allowed_redirect_uris

string[]

Custom callback URLs registered with the MCP authorization server via dynamic client registration so headless flows can redirect to them. The full set is registered when the provider is created and cannot be changed afterward — DCR has no update path, so re-creating the provider is required to change them. Omit the field or send an empty list when no custom callbacks are needed.

Example:

["https://myapp.com/oauth/callback"]

mcp_server_url

string

Example:

"https://tools.langchain.com/mcp/slack"

name

string

provider_slug

string

Response

allowed_redirect_uris

string[]

Callback URLs permitted as redirect_uri in headless auth sessions.

auth_url

string

Example:

"https://github.com/login/oauth/authorize"

authorization_params

object

Extra static query parameters appended to the authorization URL.

Show child attributes

client_id

string

Example:

"Iv1.0a1b2c3d4e5f6a7b"

code_challenge_method

string

PKCE challenge method; null when PKCE is unused.

Example:

"S256"

created_at

string

Example:

"2026-01-15T09:30:00Z"

string

Example:

"1a2b3c4d-5e6f-7081-92a3-b4c5d6e7f809"

is_dynamic_client

boolean

True when registered via OAuth dynamic client registration.

Example:

false

mcp_server_url

string

Set when the provider was discovered from an MCP server.

name

string

Example:

"GitHub"

organization_id

string

Example:

"7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0"

provider_slug

string

Example:

"github-oauth-provider"

provider_type

string

Provider family, e.g. oauth2 or mcp.

Example:

"oauth2"

token_endpoint_auth_method

string

Example:

"client_secret_post"

token_url

string

Example:

"https://github.com/login/oauth/access_token"

updated_at

string

Example:

"2026-01-15T09:30:00Z"

uses_pkce

boolean

Whether the provider uses PKCE in the authorization-code flow.

Example:

true