SIsignificant-gravitas
v1
integrations

Exchange OAuth code for tokens

Changed on
post/api/integrations/{provider}/callback

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

providerstring required

Provider name for integrations. Can be any string value, including custom provider names.

Request body

codestring required
state_tokenstring required

Response

Successful Response

idstring required
providerstring required
type'api_key' | 'oauth2' | 'user_password' | 'host_scoped' | 'device_code' required
titlestring nullable required
scopesstring[] nullable required
usernamestring nullable required
hoststring nullable

Host pattern for host-scoped or MCP server URL for MCP credentials

scopestring nullable

What a user/password login may be used for, e.g. smtp://host[:port]; null for a login saved before scopes existed

mcp_auth_scheme'basic' | 'bearer' nullable

Manual authorization scheme for MCP credentials

is_managedboolean
servicestring
service_namestring nullable
service_iconstring nullable

Changes

  • c508818c16adRevision changes
    • info

      added the optional property to the response with the status

  • 69ae03c98fdcRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status