Revoke connected app

Ends an app's access: invalidates the client's pending authorization codes and revokes every live token it holds for the authenticated user. Takes effect on the app's next request.

Idempotent while the authorization is still on record: revoking an app that was already revoked returns 200 with revokedTokens: 0.

Requires a session or a full-access API key. A profile-scoped API key, a restricted (zrk_) API key, or an OAuth access token is rejected with 403.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

clientIdstring

OAuth client id, as returned by GET /v1/me/connected-apps.

Length1 <= length <= 200

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.connectedapps.revokeConnectedApp({  path: {    clientId: 'client_abc123',  },});console.log(data);

{
  "revoked": true,
  "clientId": "late_cid_3f9c1a7b2d4e6f80a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718",
  "revokedTokens": 2,
  "invalidatedCodes": 0
}

{
  "error": "string",
  "type": "invalid_request_error",
  "code": "string",
  "param": "string",
  "platform": "string",
  "platformError": {},
  "details": {}
}

{
  "error": "Unauthorized"
}

{
  "error": "This API key has the 'messages' resource group disabled. GET /api/v1/inbox/conversations requires it. Create a key with 'messages' enabled in the dashboard API keys tab.",
  "code": "insufficient_permissions",
  "required_group": "publishing"
}

{
  "error": "string",
  "type": "invalid_request_error",
  "code": "string",
  "param": "string",
  "platform": "string",
  "platformError": {},
  "details": {}
}

Revoke connected app

Ends an app's access: invalidates the client's pending authorization codes and revokes every live token it holds for the authenticated user. Takes effect on the app's next request.

Idempotent while the authorization is still on record: revoking an app that was already revoked returns 200 with revokedTokens: 0.

Requires a session or a full-access API key. A profile-scoped API key, a restricted (zrk_) API key, or an OAuth access token is rejected with 403.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

clientIdstring

OAuth client id, as returned by GET /v1/me/connected-apps.

Length1 <= length <= 200

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.connectedapps.revokeConnectedApp({
  path: {
    clientId: 'client_abc123',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.connectedapps.revokeConnectedApp({  path: {    clientId: 'client_abc123',  },});console.log(data);

{
  "revoked": true,
  "clientId": "late_cid_3f9c1a7b2d4e6f80a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718",
  "revokedTokens": 2,
  "invalidatedCodes": 0
}

{
  "error": "string",
  "type": "invalid_request_error",
  "code": "string",
  "param": "string",
  "platform": "string",
  "platformError": {},
  "details": {}
}

{
  "error": "Unauthorized"
}

{
  "error": "This API key has the 'messages' resource group disabled. GET /api/v1/inbox/conversations requires it. Create a key with 'messages' enabled in the dashboard API keys tab.",
  "code": "insufficient_permissions",
  "required_group": "publishing"
}

{
  "error": "string",
  "type": "invalid_request_error",
  "code": "string",
  "param": "string",
  "platform": "string",
  "platformError": {},
  "details": {}
}

Revoke connected app

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

Revoke connected app

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json