curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/api-keys/66b0f7c84a1d4b2e9c3a1f2e/revoke \
-H "X-Api-Key: trk_your_parent_key"
{ "success": true }
Partner Accounts (v2)
Revoke API Key
Immediately and permanently revoke a child’s API key.
POST
/
v2
/
accounts
/
children
/
{child_id}
/
api-keys
/
{key_id}
/
revoke
curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/api-keys/66b0f7c84a1d4b2e9c3a1f2e/revoke \
-H "X-Api-Key: trk_your_parent_key"
{ "success": true }
Revokes an API key immediately. The key stops authenticating at once and cannot be restored — mint a new one if needed. Use your parent key with
accounts.write.
Path Parameters
integer
required
The child account’s
accountId.string
required
The
id of the key to revoke.Examples
curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/api-keys/66b0f7c84a1d4b2e9c3a1f2e/revoke \
-H "X-Api-Key: trk_your_parent_key"
{ "success": true }
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 404 | child_not_found / key_not_found | No such child or key. |
| 403 | not_a_parent_account / insufficient_scope / sandbox_read_only | See Accounts & Hierarchy. |
Revoking is permanent. To temporarily pause a whole child (all its keys at once) without revoking, suspend the child instead.