GEgetsales
sessions

Revoke session

End a session: active to revoked, the token refused from the next request here and within five minutes on the other services. The canonical delete of this entity (there is no delete tool). Idempotent: an already revoked or expired session answers result.already_revoked true.

Contract:

  • MCP tool revoke_session, registry package mcp.id/sessions, mount id.identity.
  • Operation action, response envelope action.
  • Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API.
post/api/sessions/{sid}/revoke

Request

  • Base URL
    https://beta.getsales.io/id/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

Session sid (id_se_...).

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

No recorded changes to this operation across all 1 revision of this API.