Update a provider

Update a custom provider configuration. Built-in providers cannot be modified.

PUT/api/providers/{scope}/{name}

Authorization

better-auth.session_token<token>

Cookie session from Better Auth. Requires X-Org-Id header for org-scoped routes.

In: cookie

Path Parameters

scope*string

Match^@[a-z0-9][a-z0-9-]*$

name*string

Header Parameters

X-Org-Id?string

Organization ID. Required for cookie auth. Not needed for API key auth (org resolved from key).

Formatuuid

Request Body

application/json

id*string

Match^[a-z0-9][a-z0-9-]*$

displayName*string

authMode*string

Value in"oauth2" | "oauth1" | "api_key" | "basic" | "custom"

clientId?string

clientSecret?string

authorizationUrl?string

tokenUrl?string

refreshUrl?string

requestTokenUrl?string

OAuth1 request token endpoint

accessTokenUrl?string

OAuth1 access token endpoint

defaultScopes?array<string>

scopeSeparator?string

pkceEnabled?boolean

tokenAuthMethod?string

Value in"client_secret_post" | "client_secret_basic"

authorizationParams?object

tokenParams?object

credentialSchema?object

credentialFieldName?string

credentialHeaderName?string

credentialHeaderPrefix?string

availableScopes?array<>

iconUrl?string

categories?array<string>

docsUrl?string

authorizedUris?array<string>

allowAllUris?boolean

curl -X PUT "https://loading/api/providers/string/string" \  -H "Content-Type: application/json" \  -d '{    "id": "string",    "displayName": "string",    "authMode": "oauth2"  }'

Empty

{
  "type": "https://docs.appstrate.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing session",
  "code": "unauthorized",
  "requestId": "req_abc123"
}

{
  "type": "https://docs.appstrate.dev/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Insufficient permissions",
  "code": "forbidden",
  "requestId": "req_abc123"
}

{
  "type": "https://docs.appstrate.dev/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Resource not found",
  "code": "not_found",
  "requestId": "req_abc123"
}