Reference
Close an endpoint for good
The revoke-ingest-endpoint tool, and the REST call it is generated from.
RESTDELETE /api/v1/ingest-endpoints/{id}
MCPrevoke-ingest-endpoint
The URL answers 404 from then on; the captures it made keep naming it. There is no un-revoke, and a new endpoint has a new URL: revoke when the integration is over, rotate when a token leaked.
Parameters
- id
The endpoint's id.
Responses
204Revoked
400The request does not match the operation's schema
403An API key cannot mint, change, rotate or revoke an ingest endpoint — a permanent credential issuing another one is an escalation. Sign in, or use a token that signing in issued.
404No such endpoint on this account, or a `suggested_project` that resolves to nothing — and the answer a project-restricted credential gets for every operation here, since the inbox has no project for a restriction to narrow.
Generated from the spec this operation is implemented against, so the two names above cannot disagree with the surface a client sees.