Skip to content
EverrunsEverruns
Everruns Cloud is open in early access. Run agents without operating the platform.

Revise an agent draft from a conversation with the agent builder. Returns the draft only; nothing is created.

POST
/v1/agents/draft
curl --request POST \
  --url https://app.everruns.com/api/v1/agents/draft

Responses

Section titled “ Responses ”

200

Section titled “200”

Success

Media typeapplication/json
object
draft
required

The agent the builder is shaping. Nothing is created from it until the user confirms.

object
capabilities

Capability ids to attach.

Array<string>
channels

Channel kinds to create as drafts: public_chat, ag_ui, webhook, slack.

Array<string>
description
string
display_name
string
name

Addressable name (lowercase slug).

string
schedule
One of:

When the agent wakes itself.

object
cron
required

Five-field cron expression (minute hour day month weekday).

string
message
required

Message the agent receives on each scheduled run.

string
timezone
string
system_prompt
string
reply
required

The builder’s answer to the last message.

string
suggestions
required

Short follow-ups the user can send next.

Array<string>
Examplegenerated
{
  "draft": {
    "capabilities": [
      "example"
    ],
    "channels": [
      "example"
    ],
    "description": "example",
    "display_name": "example",
    "name": "example",
    "schedule": {
      "cron": "example",
      "message": "example",
      "timezone": "example"
    },
    "system_prompt": "example"
  },
  "reply": "example",
  "suggestions": [
    "example"
  ]
}