v1
latestOpenAPI 3.1.02026-07-2210284274.4 KBRemove 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.
Path parameters
The agent's url, URL-encoded (e.g. https%3A%2F%2Fagent.example.com%2Fmcp).
The agent's url, URL-encoded (e.g. https%3A%2F%2Fagent.example.com%2Fmcp).
Query parameters
WorkOS organization id to act on. Defaults to the caller's primary organization. Use this from a multi-org session (or when shelling with a user JWT) to target a non-primary org. Verification goes through WorkOS membership lookup; non-members get 403.
WorkOS organization id to act on. Defaults to the caller's primary organization. Use this from a multi-org session (or when shelling with a user JWT) to target a non-primary org. Verification goes through WorkOS membership lookup; non-members get 403.
Response
Agent removed.