delete_agent

Permanently delete an Agent definition by its caller-relative name: bare with a standalone personal credential, me/name for private content in organization scope, or <team>/name for a bound team. A bare organization-scoped name denotes the read-only organization catalogue. Credential assignments to a deleted definition are cleared by the storage relationship.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Caller-relative address: bare with a standalone personal credential, me/name in private organization space, or <team>/name for a bound team.

Response

Field	Type	Description
deleted	string	The submitted address, confirming deletion.

Example

{ "name": "engineering/security-reviewer" }

Result:

{ "deleted": "engineering/security-reviewer" }

Errors

Code	Cause
agent_not_found	No Agent remains at the requested name in the target space, including if it was renamed while this call was pending.
empty_name	The name is empty after removing the team prefix.
forbidden	The credential lacks delete authority, uses me/ outside organization scope, or targets the read-only organization catalogue.
team_not_found	No team with that prefix is bound to this credential.
personal_cannot_address_team	A standalone personal credential used a Team prefix.
no_personal_space	A userless organization credential used me/name.
invalid_arguments	Input is missing or does not match the schema.
internal_error	An unexpected server error occurred.

Notes

• The tool is governed and requires Tools and tool-policy admission. A standalone personal target additionally requires its Agent-delete permission; a Team target requires a binding and the matching Team permission; me/name requires an acting user with active organization membership.
• Deleting an assigned definition clears the assignment; it does not select a replacement.
• Organization-catalog deletion remains a dashboard management action.