> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeptar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents overview

> Agents are the configurable voice personas you call into.

An **agent** is the unit of configuration for a voice conversation. It owns:

* A **name** the team uses to identify it.
* A **system prompt** that steers the underlying LLM.
* An **organization** that scopes who can see and edit it.
* A **creator** — the user who first created it.

Agents are mutable: you can rename them, edit the system prompt (via the web UI's draft flow), and duplicate them. Deleting an agent cascades to any conversations that referenced it.

## Lifecycle

```mermaid theme={null}
flowchart LR
  Create([POST /v1/agents]) --> Draft[(Edit drafts in web UI)]
  Draft --> Preview([POST /v1/agents/:id/conversations])
  Preview --> Publish([PATCH /v1/agents/:id])
  Publish --> Duplicate([POST /v1/agents/:id/duplicate])
  Publish --> Delete([DELETE /v1/agents/:id])
```

## Scope rules

All agent endpoints are **organization-scoped**. The endpoints read the requester's active organization from the session and only return agents that belong to it. Cross-tenant lookups return `404 agent_not_found` — there is no enumeration distinction between "wrong org" and "doesn't exist."

## Related guides

* [Conversations](/api-reference/conversations/overview) — start a preview call against an agent.
* [Workspaces](/api-reference/organizations/overview) — set which organization is active.