# Can I create and edit VARTA agents through the API?

Not through the public API — /v1 is the runtime surface (load an agent, hold a conversation, place a call), and authoring an agent (create, build steps, rules, routing, tone, reflex phrases) happens in the VARTA studio. Most customers author there, where AI assistance is faster; the waitlist is the way in for anyone who needs it programmatically.


No — not yet. `/v1` is the **runtime** surface: it loads an agent you've
already built, holds a conversation with it turn by turn, places and
monitors telephone calls, and registers the telephony you dial through. It
does not author agents.

## What's absent

There is no `/v1` way to:

- **Create** an agent.
- **Build** or edit its conversation flow — steps, branches, the sequence a
  call moves through.
- Define its **rules** — what counts as a match, what triggers a jump to a
  different step.
- Configure its **routing** — where a given intent or slot value sends the
  conversation next.
- Set its **tone** — how the agent is meant to sound and respond in
  character.
- Author its **reflex phrases** — the fixed responses it reaches for on
  specific triggers.

All of that happens in the VARTA studio today. If you've read the
[Quickstart](/docs/quickstart), the agent id you loaded in step one — the
thing `/v1` treats as an opaque, already-built unit — is exactly what the
studio produces.

## Why

Most customers author in the studio, where an AI assistant does a large part
of the flow-building for them and iteration is faster than any API call
sequence could be. Programmatic authoring is what a minority of customers
need, not the common path — so it isn't where the runtime API has been
built out first.

## If you need programmatic authoring

There's no client library for this either — no TypeScript or Python
package. Every example on this site talks to `/v1` with plain `fetch` or
`curl`, and that's deliberate: it's what actually exists to call.

If your use case genuinely needs to create or edit agents from code rather
than the studio, that's a different question from what `/v1` answers today.
Join the waitlist to talk about it.