Enable an app
Turns the app on: it signs people in and gets tokens again, with its settings as they were. Needs `org.apps.edit`. Recorded as `app.updated`.
/v1/orgs/{org}/brands/{brand}/apps/{app}/enableTurns the app on: it signs people in and gets tokens again, with its settings as they were. Needs org.apps.edit. Recorded as app.updated.
Authorization
bearer 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
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$The brand's id
^brd_[0-9a-hjkmnp-tv-z]{26}$The app's client_id: an app_… id, or the URL of the metadata document an app registered itself with
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brands/brd_01h455vb4pex5vsknk084sn02q/apps/app_01h455vb4pex5vsknk084sn02q/enable" \ -H "Authorization: Bearer $SYNQ_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "app_01h455vb4pex5vsknk084sn02q", "brand_id": "brd_01h455vb4pex5vsknk084sn02q", "name": "Acme", "app_type": "web", "source": "dashboard", "first_party": true, "own_ui_sign_in": true, "sign_in_methods": [ "email", "custom-acme-guild" ], "test_sign_ins": true, "sign_in_claims": true, "disabled": true, "development": true, "redirect_uris": [ "https://app.acme.example" ], "post_logout_redirect_uris": [ "https://app.acme.example" ], "backchannel_logout_uri": "https://app.acme.example", "backchannel_logout_session_required": true, "client_uri": "https://app.acme.example", "logo_uri": "https://app.acme.example", "policy_uri": "https://app.acme.example", "tos_uri": "https://app.acme.example", "initiate_login_uri": "https://app.acme.example", "jwks_uri": "https://app.acme.example", "token_endpoint_auth_method": "client_secret_basic", "pkce_optional": true, "spa_refresh_tokens": true, "refresh_token_reuse_window_seconds": 0, "previous_secret_expires_at": "2026-10-21T12:00:00.000Z", "last_used_at": "2026-10-21T12:00:00.000Z", "created_at": "2026-10-21T12:00:00.000Z", "warnings": [ { "code": "loopback_redirect_uris", "message": "string" } ]}Disable an app POST
Turns the app off: it signs no one in and gets no tokens until it is enabled again, and its settings stay as they are. Needs `org.apps.edit`. Recorded as `app.updated`.
Rotate an app's secret POST
A new secret, in the response this once. The current one keeps working for `overlap_seconds`, so the app can be redeployed with the new one first. Needs `org.apps.edit`. A person needs a sign-in at Synq from the last 5 minutes whose time Synq proved (send them to sign in with `max_age=300`), else 403 `fresh_sign_in_required`; an API key never does. The one exception is the first new secret of an app the person made since they signed in, which that sign-in was already handed a secret for: onboarding makes the app and shows its secret later. Recorded as `app.secret_rotated`.