SynqDocs
Management APIApproval requests

Read an approval request

Its target, the change, its preview and whether it was approved, declined or expired, and what approving made. The MCP host reads it to see what the person decided. Needs `org.read`.

GET/v1/orgs/{org}/approval-requests/{request}

Its target, the change, its preview and whether it was approved, declined or expired, and what approving made. The MCP host reads it to see what the person decided. Needs org.read.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$
request*string

The approval request's id

Match^apr_[0-9a-hjkmnp-tv-z]{26}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/approval-requests/apr_01h455vb4pex5vsknk084sn02q" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "id": "apr_01h455vb4pex5vsknk084sn02q",  "kind": "app.redirect_uris",  "target": {    "brand_id": "brd_01h455vb4pex5vsknk084sn02q",    "app_id": "app_01h455vb4pex5vsknk084sn02q"  },  "change": {    "redirect_uris": [      "https://acme.example/callback"    ]  },  "title": "Make a token gate",  "preview": "Set the redirect URIs of the web app “Acme web” in the brand “Acme” to 1 address. Adds https://acme.example/callback.",  "details": [    {      "field": "redirect_uris",      "label": "Redirect URIs",      "values": [        {          "text": "https://acme.example/callback",          "code": true,          "tag": "new"        }      ]    }  ],  "changes": [    {      "kind": "app.redirect_uris",      "operation": "string",      "target": {        "brand_id": "brd_01h455vb4pex5vsknk084sn02q",        "app_id": "app_01h455vb4pex5vsknk084sn02q"      },      "title": "string",      "preview": "string",      "details": [        {          "field": "redirect_uris",          "label": "Redirect URIs",          "values": [            {              "text": "https://acme.example/callback",              "code": true,              "tag": "new"            }          ]        }      ],      "result": {        "app_id": "app_01h455vb4pex5vsknk084sn02q",        "resource_id": "string"      }    }  ],  "hash": "9f2c6a…",  "status": "awaiting_approval",  "reason": "string",  "last_refusal": {    "code": "plan_feature_unavailable",    "detail": "string",    "at": "2026-10-21T12:00:00.000Z"  },  "asked_from": "string",  "asked_from_name": "Claude",  "approve_url": "https://app.acme.example",  "applied_at_once": false,  "asks_because": "sign_in_security",  "fresh_sign_in": false,  "relied_on_sign_in": {    "signed_in_at": "2026-10-21T12:00:00.000Z",    "within_window": false  },  "result": {    "app_id": "app_01h455vb4pex5vsknk084sn02q",    "invite_id": "inv_01h455vb4pex5vsknk084sn02q",    "key_id": "string",    "resource_id": "string"  },  "expires_at": "2026-10-21T12:00:00.000Z",  "decided_at": "2026-10-21T12:00:00.000Z",  "created_at": "2026-10-21T12:00:00.000Z"}

Add a provider your app verifies POST

A provider whose people your own service proves, such as your Telegram bot or your game's server: a name and an icon, with no address or app at Synq, since your server says who someone is there. People link an account at it from your app with a link code (`POST /me/v1/link-codes`), which your server redeems (`POST …/link-codes/redeem`) and they confirm in the app; your server can add one for someone it knows (`POST …/users/{user}/identities`); and where `sign_in_tickets` is on, it makes sign-in links for them (`POST …/sign-in-tickets`). It is never a way to sign in on the brand's pages, and never counts as one. It is off until `POST …/enable`. At most 20 of the brand's own providers of every kind (409 `conflict`); an id the brand has is 409 `sign_in_provider_exists`. Needs `org.connections.edit`, and a person's sign-in from the last 5 minutes for `sign_in_tickets` (403 `fresh_sign_in_required`). Recorded as `brand.updated` with `provider` and each setting under `custom_sign_in_provider.`.

List your approval requests GET

The changes the calling person asked for from an MCP host, newest first, each as `GET …/approval-requests/{request}` answers it: what it does, its status and, while it waits, its `approve_url`. `status=awaiting_approval` lists those still waiting for them to decide (the dashboard's "Waiting for you"); left out, every status. Only the person's own: only they decide them. One about a brand they hold no role in any more isn't listed. An API key asks for none, so its list is empty. Needs `org.read`.