Authorized apps
List the apps and agents members authorized with OAuth, and disconnect your own, with the AbuseZero REST API.
An authorized app is an app or agent a member approved with OAuth, such as the AbuseZero CLI, an MCP client or your own OAuth app. It acts as that member, with their role, in the workspaces it was granted. The same apps appear in Developers → OAuth apps, on the Authorized apps tab.
Both calls need a member's own OAuth sign-in: which apps you see follows your role, and you disconnect only your own. A machine client gets MEMBER_SIGN_IN_REQUIRED. An API key gets MEMBER_SIGN_IN_REQUIRED for the list, and KEY_PERMISSION_DENIED for disconnecting, which needs operations:management.
The authorized app object
{
"object": "authorized_app",
"id": "73492810562018437529",
"name": "AbuseZero CLI",
"trust": "first_party",
"destination": null,
"scopes": ["operations:general", "operations:configuration", "operations:management"],
"member": { "name": "Priya Shah", "email": "priya@example.com", "role": "developer", "you": true, "former": false },
"approved_at": "2026-11-10T09:00:00.000Z"
}| Field | Type | Description |
|---|---|---|
object | "authorized_app" | The object type. |
id | string | The approval's ID. Use it to disconnect the app. |
name | string | The app's name, as the app gave it. |
trust | first_party, verified or unverified | first_party for AbuseZero's own apps, verified for apps AbuseZero has checked, otherwise unverified. |
destination | string or null | The web host the app sends its approvals to. null for an app on the member's own device, such as the AbuseZero CLI or a local agent. |
scopes | array of strings | The scopes the member approved. |
member | object or null | The member who approved it: name, email, role, whether it's you, and former when they've left the workspace. |
approved_at | string | When the member last approved it. |
List authorized apps
Returns the apps of the workspace's members your role lets you see, newest approval first. The owner sees every member's. An admin sees their own and those of members who aren't admins. Everyone else sees only their own.
| Method | Path | Scope | Idempotency-Key |
|---|---|---|---|
GET | /v1/authorized-apps | operations:general | Not used |
Also available as abusezero authorized-apps list in the AbuseZero CLI, abusezero_list_authorized_apps on the AbuseZero MCP server and authorizedApps() in the AbuseZero Node.js SDK.
Query parameters
| Parameter | Type | Required | Limits | Description |
|---|---|---|---|---|
view | everyone or mine | No | Default everyone | everyone lists every app your role lets you see. mine lists only your own. |
limit | integer | No | 1 to 100, default 50 | How many apps to return. |
cursor | string | No | The next_cursor from the previous page, unchanged. |
Example
curl "https://api.abusezero.com/v1/authorized-apps?view=mine" \
-H "Authorization: Bearer $ABUSEZERO_ACCESS_TOKEN" \
-H "AbuseZero-Workspace: 59670872302871291997"Response
Returns 200 with a list of authorized app objects.
Disconnect an authorized app
Disconnects one of your own authorized apps. It loses access at once, in every workspace, and its access and refresh tokens stop working. Another member's app is answered as one that doesn't exist.
| Method | Path | Scope | Idempotency-Key |
|---|---|---|---|
POST | /v1/authorized-apps/{id}/disconnect | operations:management | Required |
Also available as abusezero authorized-apps disconnect in the AbuseZero CLI, abusezero_disconnect_authorized_app on the AbuseZero MCP server and disconnectAuthorizedApp() in the AbuseZero Node.js SDK.
Disconnecting the app that makes the request ends that app's own access too.
Example
curl -X POST https://api.abusezero.com/v1/authorized-apps/73492810562018437529/disconnect \
-H "Authorization: Bearer $ABUSEZERO_ACCESS_TOKEN" \
-H "AbuseZero-Workspace: 59670872302871291997" \
-H "Idempotency-Key: disconnect-old-agent"Response
Returns 201 with { "object": "deleted", "id": "73492810562018437529", "deleted": true }.
Errors
| Code | Status | Meaning |
|---|---|---|
OAUTH_GRANT_NOT_FOUND | 404 | You have no authorized app with this ID. |
MEMBER_SIGN_IN_REQUIRED | 403 | The request used a machine client. Use a member's OAuth sign-in. |
KEY_PERMISSION_DENIED | 403 | The request used an API key. Use a member's OAuth sign-in. |
For every other code, see REST API errors.
Related
How is this guide?
Last updated on