Skip to main content

Patch Agent

PATCH 

/v1/agents/:agent_id

Update an agent's name, display name, and/or description. Does not modify agent versions or configuration.

When validateOnly=true, all validations run (including name conflict checks) but no changes are persisted.

Status Codes:

  • 200: Agent updated successfully (or validation passed when validateOnly=true)
  • 400: Validation error (invalid input)
  • 403: Forbidden (cannot update global agents)
  • 404: Agent not found
  • 409: Conflict (name conflict)
  • 500: Internal server error

Request

Responses

Successful Response