Organization settings

Revoke a connected app

Revoke one connected app for the whole organization. Where the app has revocation rights on, only the person who connected it, an owner or an admin may revoke it. Scheduled and repeating mail it created is stopped.

Person only: a dashboard session. The person's role must hold oauth_grants:manage. API keys, agent connection keys and agents are refused.

post/oauth-grants/{id}/revoke

Request

  • Base URL
    https://api.primitive.dev/v1
  • URL
    https://api.primitive.dev/v1/oauth-grants/{id}/revoke
  • Auth
    HTTP bearer

Path parameters

idstring required

The connected app id from listOAuthGrants.

Headers

Idempotency-Keystring

Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.

Response

Success

successtrue required

Changes

No operation changes recorded.