Create or update a provider app

POST/admin/provider-apps

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bot_token?string

Bot token. Omit to preserve the encrypted value when updating.

bot_username?string

Public Telegram bot username

client_id?string

OAuth client or application ID

client_secret?string

OAuth client secret. Omit to preserve the existing secret when updating.

connection_mode?string

Provider connection mode; inferred when omitted

instance_url?string

Federated provider instance URL

is_active?boolean

Whether this app should be active. Defaults to true.

name?string

Optional provider app display name

provider*string

Provider key

redirect_uri?string

OAuth redirect URI

webhook_secret?string

Webhook verification secret. Omit to preserve the encrypted value when updating.

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/admin/provider-apps" \  -H "Content-Type: application/json" \  -d '{    "provider": "string"  }'

{  "$schema": "https://example.com/api/v1/schemas/SaveProviderAppResponse.json",  "app": {    "bot_token_configured": true,    "bot_username": "string",    "client_id": "string",    "connection_mode": "string",    "created_at": "string",    "deletable": true,    "editable": true,    "id": "string",    "instance_url": "string",    "is_active": true,    "name": "string",    "provider": "string",    "redirect_uri": "string",    "secret_configured": true,    "shadowed_by_environment": true,    "source": "environment",    "updated_at": "string",    "webhook_secret_configured": true  },  "existed": true,  "requires_restart": true}