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

Edit the draft

Changed on Oct 30, 2026

Changes settings on the draft. Omitted settings stay as they are. Pass the revision you read as expectedRevision to fail with 409 if anyone edited the draft since, instead of applying on top of their edit.

put/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

expectedRevisioninteger

The draft's revision when you read it. When sent, the edit is refused if the draft changed since; when omitted, it applies on top of the latest edit.

Response

The edited draft.

Changes

Oct 30, 2026eb601d4577cd Revision changes
- breaking
  added the new required request property ///
- 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
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property ///
- info
  added the required property /// to the response with the status
Oct 29, 202657a93528ce77 Revision changes
- info
  endpoint added

Operation history