staqlydocs
REST APIAPI referenceChannels

Register the workspace's own developer app for an OAuth platform

Register the workspace's own developer app for an OAuth platform (channels:manage)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

PUT
/v1/providers/{id}/app

The client secret is stored sealed and never returned. Needed when the server has no app for the platform (the Community Edition).

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Replays the stored response when the same key is repeated with the same method, path, query string and body within 24 hours (422 idempotency_mismatch with a different request, 409 idempotency_in_progress while the first one runs). Not applied to multipart uploads or to responses that carry a secret.

Lengthlength <= 200

Request Body

application/json
  1. body

An OAuth client the workspace registered with a platform

client_id*string
client_secret*string

Response Body

Saved

curl -X PUT 'https://staqly.example.com/v1/providers/string/app' \  -H 'Content-Type: application/json' \  -d '{}'
Empty