# Cozmo API

## Docs

- [Get agent session](https://docs.cozmox.ai/api-reference/agent-sessions/get-agent-session.md): Get the details of an agent session by ID
- [Start agent session](https://docs.cozmox.ai/api-reference/agent-sessions/start-agent-session.md): Creates the session record, appends the initial instruction as a user message event, and triggers the agent workflow — all in a single call. The session_id must be a client-generated UUID v4 and is used to idempotently reference the session afterward.
- [Create agent](https://docs.cozmox.ai/api-reference/agents/create-agent.md): Create a new AI agent in the organization
- [Delete agent](https://docs.cozmox.ai/api-reference/agents/delete-agent.md): Delete an agent by ID
- [Get agent](https://docs.cozmox.ai/api-reference/agents/get-agent.md): Get agent details by ID
- [List agents](https://docs.cozmox.ai/api-reference/agents/list-agents.md): Get a paginated list of agents for the organization
- [Update agent](https://docs.cozmox.ai/api-reference/agents/update-agent.md): Update agent details (partial update)
- [Get call details](https://docs.cozmox.ai/api-reference/calls/get-call-details.md): Returns full details for a specific call including prospect and agent info
- [List calls](https://docs.cozmox.ai/api-reference/calls/list-calls.md): Returns a paginated list of calls for the organization with optional filters
- [List voices](https://docs.cozmox.ai/api-reference/voices/list-voices.md): Get a paginated list of available voices from the specified provider
- [Create workflow run with prospect](https://docs.cozmox.ai/api-reference/workflow-runs/create-workflow-run-with-prospect.md): Create a new workflow run with prospect creation in a single operation (API endpoint)
- [Get workflow](https://docs.cozmox.ai/api-reference/workflows/get-workflow.md): Get a single workflow by ID with its latest definition
- [List workflows](https://docs.cozmox.ai/api-reference/workflows/list-workflows.md): Get a paginated list of workflows with filtering

## OpenAPI Specs

- [openapi](https://docs.cozmox.ai/openapi.yaml)
- [openapi.sdk](https://docs.cozmox.ai/openapi.sdk.yaml)