Remove an agent
Remove one registered agent identified by its url.
A currently-public agent is reflected in the published brand.json manifest. To prevent the registry catalog and brand.json from silently disagreeing, this endpoint returns 409 unpublish_first when the agent is public — PATCH /api/me/agents/{url} with visibility: "private" first (or call DELETE /api/me/member-profile/agents/{index}/publish to reconcile the manifest), then re-issue the DELETE.
Request
- Base URLhttps://agenticadvertising.org
- URLhttps://agenticadvertising.org/api/me/agents/{url}
- Auth
- HTTP bearer
- or OAuth 2Authorization code: https://agenticadvertising.org/authorizeToken URL: https://agenticadvertising.org/token
Path parameters
The agent's url, URL-encoded (e.g. https%3A%2F%2Fagent.example.com%2Fmcp).
Query parameters
WorkOS organization id to act on. Human sessions and user JWTs must select it explicitly. WorkOS API keys may omit it because their validated credential already carries an exact organization scope; when supplied with an API key it must match that scope.
Response
Agent removed.
Changes
No recorded changes to this operation across all 71 revisions of this API.