Substy Developers
Account and agency

Get account action status

Check an actionId returned by request_account_action after the user completes verification. Returns its status, expiry and recorded outcome. PENDING or RUNNING does not confirm the requested account change; an expired action requires a new request.

GET/v1/agencies/{agencyId}/account/actions/{actionId}

Check an actionId returned by request_account_action after the user completes verification. Returns its status, expiry and recorded outcome. PENDING or RUNNING does not confirm the requested account change; an expired action requires a new request.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
actionId*string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agencies/string/account/actions/string" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "data": {    "actionId": "string",    "kind": "set_primary_email",    "status": "PENDING",    "result": null,    "expiresAt": "string"  },  "meta": {    "requestId": "string"  }}

Request account action POST

Request a sensitive account change: manage emails, change password, connect or unlink a sign-in provider, revoke a session, or delete the account. Supply the action kind and its matching payload. Returns an actionId and a verification URL for the user; check get_account_action_status afterwards. Passwords and verification codes belong only in the verification page.

Get agency profile GET

Read the selected agency’s ID, name, slug and imageUrl. Use its exact name as confirmation when requesting agency deletion.