# Agent Management

Endpoints for managing agents and agent workflows

## Get Agents

 - [GET /agents](https://hypatos.redocly.app/openapi/agent-management/external_get_agents.md): List agents for the authenticated company.

A summary projection: prompt and configuration are returned empty, toolIds null.
systemPrompt and outputFormat are returned today but are expected to be omitted in a future
release. Retrieve an agent by id for its complete representation. The namesAndVersions lookup
returns prompt and configuration populated; toolIds is null in any list response.

## Create Agent

 - [POST /agents](https://hypatos.redocly.app/openapi/agent-management/external_create_agent.md): Create a custom agent; non-default OOTB identity or source provenance returns HTTP 422.

## Get Agent

 - [GET /agents/{id}](https://hypatos.redocly.app/openapi/agent-management/external_get_agent.md)

## Update Agent

 - [PUT /agents/{id}](https://hypatos.redocly.app/openapi/agent-management/external_update_agent.md): Replace a custom agent. Persisted OOTB agents return HTTP 422; use root PATCH to customize them.

## Patch Agent

 - [PATCH /agents/{id}](https://hypatos.redocly.app/openapi/agent-management/external_patch_agent.md): Patch by persisted kind: OOTB allows prompt/description/editors; custom keeps partial-update semantics.

For custom agents, omitted fields stay unchanged, explicit null clears nullable fields, and companyId and
name are immutable. A custom-only or otherwise protected field sent to an OOTB agent is rejected with 422.

## Delete Agent

 - [DELETE /agents/{id}](https://hypatos.redocly.app/openapi/agent-management/external_delete_agent.md)

## Get Workflows

 - [GET /agent-workflows](https://hypatos.redocly.app/openapi/agent-management/external_get_workflows.md)

## Create Workflow

 - [POST /agent-workflows](https://hypatos.redocly.app/openapi/agent-management/external_create_workflow.md): Create a custom workflow; OOTB identity or source provenance in the request returns HTTP 422.

## Get Workflow

 - [GET /agent-workflows/{id}](https://hypatos.redocly.app/openapi/agent-management/external_get_workflow.md)

## Update Workflow

 - [PUT /agent-workflows/{id}](https://hypatos.redocly.app/openapi/agent-management/external_update_workflow.md): Replace a custom workflow. Persisted OOTB workflows return HTTP 422; use root PATCH to customize them.

## Patch Workflow

 - [PATCH /agent-workflows/{id}](https://hypatos.redocly.app/openapi/agent-management/external_patch_workflow.md): Patch by persisted kind after ownership is established.

OOTB workflows accept only workflowConfiguration.steps, name, description, projects, and editors;
a protected field sent to an OOTB workflow is rejected with 422. Custom workflows keep their existing
partial-update contract.

## Delete Workflow

 - [DELETE /agent-workflows/{id}](https://hypatos.redocly.app/openapi/agent-management/external_delete_workflow.md)