Agent17

Agent Config6

Agent Endpoint4

Analytics2

Autoimprove8

Benchmark6

Call11

Chat5

CLI Auth1

Config2

Customer Flow8

Customer Flow Edge Case4

Dashboard10

Health1

HTTP Request Definition4

Issue3

Knowledge Base3

Live Report8

Me4

Metric11

Metric Collection Job6

Metric Policy5

Organization Project5

Organization Project API Key3

Organization Project Member4

Phone Number6

Project1

Prospect Simulation3

Simulation17

Simulation Environment5

Simulation Job3

Simulation Persona5

Simulation Run Plan5

Simulation Run Plan Job7

Simulation Template1

Usage1

Webhook4

Webhooks

Metric1

Webhook1

Agent

Start a draft

Changed on Oct 30, 2026

Opens the agent's one shared draft, a copy of the live version or of an older published version. Fails with 409 when a draft is already open.

post/v1/agent/{agentId}/draft

Request

Base URL
https://api.roark.ai
URL
https://api.roark.ai/v1/agent/{agentId}/draft
Auth
HTTP bearer

Path parameters

agentIdstring uuid required

Request body

fromVersionIdstring uuid

Start from this published version instead of the live one.

Response

The new draft.

Changes

Oct 30, 2026eb601d4577cd Revision changes
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- info
  added the required property /// to the response with the status
Oct 29, 202657a93528ce77 Revision changes
- breaking
  removed the required property / from the response with the status
- info
  added the required property / to the response with the status

Operation history (3 revisions)