Skip to main content
POST
Remove Agents from Group
Use this API to remove one or more agents from a group. The operation is idempotent — removing an id that is not a member is a silent success. The agents themselves are not deleted — only their membership in this group is removed. To delete a custom agent (and have it removed from every group), use Delete Agent.

Endpoint

POST https://api.velt.dev/v2/agents/groups/remove-agents

Headers

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

data
object
required

Example Requests

1. Remove a single agent

2. Remove multiple agents

Response

Success Response

Failure Response

Errors:
  • NOT_FOUND — group does not exist
  • INVALID_ARGUMENT — empty agentIds array, or any id is empty