Start a private setup chat
curl --request POST \
--url https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"authoring_model_ref": "<string>",
"operation_id": "<string>",
"source": {
"kind": "blank"
},
"message": "<string>",
"save": true
}
'import requests
url = "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts"
payload = {
"authoring_model_ref": "<string>",
"operation_id": "<string>",
"source": { "kind": "blank" },
"message": "<string>",
"save": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
authoring_model_ref: '<string>',
operation_id: '<string>',
source: {kind: 'blank'},
message: '<string>',
save: true
})
};
fetch('https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'authoring_model_ref' => '<string>',
'operation_id' => '<string>',
'source' => [
'kind' => 'blank'
],
'message' => '<string>',
'save' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts"
payload := strings.NewReader("{\n \"authoring_model_ref\": \"<string>\",\n \"operation_id\": \"<string>\",\n \"source\": {\n \"kind\": \"blank\"\n },\n \"message\": \"<string>\",\n \"save\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"authoring_model_ref\": \"<string>\",\n \"operation_id\": \"<string>\",\n \"source\": {\n \"kind\": \"blank\"\n },\n \"message\": \"<string>\",\n \"save\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"authoring_model_ref\": \"<string>\",\n \"operation_id\": \"<string>\",\n \"source\": {\n \"kind\": \"blank\"\n },\n \"message\": \"<string>\",\n \"save\": true\n}"
response = http.request(request)
puts response.read_body{
"authoring_model_ref": "<string>",
"cancelled_through": "<string>",
"etag": "<string>",
"id": "<string>",
"state": "<string>",
"title": "<string>",
"candidate": {
"canonical_digest": "<string>",
"definition": {
"config": {
"name": "<string>",
"x-agentsfleet": {
"budget": {
"daily_nanos": "<string>",
"monthly_nanos": "<string>"
},
"tools": [
"<string>"
],
"context": {
"context_cap_tokens": 1,
"memory_checkpoint_every": 1,
"stage_chunk_threshold": 0.5,
"tool_window": 1
},
"credentials": [
"<string>"
],
"gates": {
"anomaly_rules": [
{
"pattern": "same_action",
"threshold_count": 5000,
"threshold_window_s": 43200
}
],
"rules": [
{
"action": "<string>",
"tool": "<string>",
"behavior": "approve",
"blast_radius": "<string>",
"condition": "<string>",
"gate_kind": "<string>"
}
],
"timeout_ms": 123
},
"model": "<string>",
"network": {
"allow": [
"<string>"
],
"read_only": true,
"read_post_paths": [
"<string>"
]
},
"repositories": [
"<string>"
],
"repository_access": "read",
"repository_base": "<string>",
"triggers": [
{
"source": "<string>",
"type": "webhook",
"credential_name": "<string>",
"events": [
"<string>"
],
"repositories": [
"<string>"
],
"verifier": {
"header": "<string>",
"scheme": "body-hex-sha256"
}
}
]
}
},
"description": "<string>",
"instructions_md": "<string>",
"schema_version": 1
},
"id": "<string>",
"policy_semantics": "<string>",
"revision": "<string>"
},
"closed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"linked_fleet_id": "<string>",
"publication": {
"canonical_digest": "<string>",
"library_id": "<string>",
"revision_id": "<string>"
},
"review": {},
"accepted": {
"replayed": true,
"sequence": "<string>",
"status": "<string>"
}
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}Private setup chats
Start a private setup chat
Starts a private setup chat. Requires fleet:write. Use the body’s operation_id for retries; Idempotency-Key is refused. Imported native setups keep the selected revision.
POST
/
v1
/
workspaces
/
{workspace_id}
/
drafts
Start a private setup chat
curl --request POST \
--url https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"authoring_model_ref": "<string>",
"operation_id": "<string>",
"source": {
"kind": "blank"
},
"message": "<string>",
"save": true
}
'import requests
url = "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts"
payload = {
"authoring_model_ref": "<string>",
"operation_id": "<string>",
"source": { "kind": "blank" },
"message": "<string>",
"save": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
authoring_model_ref: '<string>',
operation_id: '<string>',
source: {kind: 'blank'},
message: '<string>',
save: true
})
};
fetch('https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'authoring_model_ref' => '<string>',
'operation_id' => '<string>',
'source' => [
'kind' => 'blank'
],
'message' => '<string>',
'save' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts"
payload := strings.NewReader("{\n \"authoring_model_ref\": \"<string>\",\n \"operation_id\": \"<string>\",\n \"source\": {\n \"kind\": \"blank\"\n },\n \"message\": \"<string>\",\n \"save\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"authoring_model_ref\": \"<string>\",\n \"operation_id\": \"<string>\",\n \"source\": {\n \"kind\": \"blank\"\n },\n \"message\": \"<string>\",\n \"save\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agentsfleet.net/v1/workspaces/{workspace_id}/drafts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"authoring_model_ref\": \"<string>\",\n \"operation_id\": \"<string>\",\n \"source\": {\n \"kind\": \"blank\"\n },\n \"message\": \"<string>\",\n \"save\": true\n}"
response = http.request(request)
puts response.read_body{
"authoring_model_ref": "<string>",
"cancelled_through": "<string>",
"etag": "<string>",
"id": "<string>",
"state": "<string>",
"title": "<string>",
"candidate": {
"canonical_digest": "<string>",
"definition": {
"config": {
"name": "<string>",
"x-agentsfleet": {
"budget": {
"daily_nanos": "<string>",
"monthly_nanos": "<string>"
},
"tools": [
"<string>"
],
"context": {
"context_cap_tokens": 1,
"memory_checkpoint_every": 1,
"stage_chunk_threshold": 0.5,
"tool_window": 1
},
"credentials": [
"<string>"
],
"gates": {
"anomaly_rules": [
{
"pattern": "same_action",
"threshold_count": 5000,
"threshold_window_s": 43200
}
],
"rules": [
{
"action": "<string>",
"tool": "<string>",
"behavior": "approve",
"blast_radius": "<string>",
"condition": "<string>",
"gate_kind": "<string>"
}
],
"timeout_ms": 123
},
"model": "<string>",
"network": {
"allow": [
"<string>"
],
"read_only": true,
"read_post_paths": [
"<string>"
]
},
"repositories": [
"<string>"
],
"repository_access": "read",
"repository_base": "<string>",
"triggers": [
{
"source": "<string>",
"type": "webhook",
"credential_name": "<string>",
"events": [
"<string>"
],
"repositories": [
"<string>"
],
"verifier": {
"header": "<string>",
"scheme": "body-hex-sha256"
}
}
]
}
},
"description": "<string>",
"instructions_md": "<string>",
"schema_version": 1
},
"id": "<string>",
"policy_semantics": "<string>",
"revision": "<string>"
},
"closed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"linked_fleet_id": "<string>",
"publication": {
"canonical_digest": "<string>",
"library_id": "<string>",
"revision_id": "<string>"
},
"review": {},
"accepted": {
"replayed": true,
"sequence": "<string>",
"status": "<string>"
}
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}{
"detail": "<string>",
"docs_uri": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"title": "<string>",
"action_id": "<string>",
"current_state": "<string>",
"etag": "<string>",
"gate_id": "<string>",
"outcome": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by": "<string>",
"user_message": "<string>"
}Authorizations
Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.
Path Parameters
Workspace identifier (version 7 universally unique identifier, or UUID).
Body
application/json
Atomically create a private draft and optional first message.
Copy an eligible ref from GET /v1/workspaces/{workspace_id}/models?purpose=authoring.
Required retry identifier: a version 7 universally unique identifier (UUID).
Retry within 24 hours with the same operation_id and unchanged request. After
that window, inspect existing resources before retrying.
Exact native source to capture.
- Option 1
- Option 2
- Option 3
- Option 4
Show child attributes
Show child attributes
Optional initial user text; 1..32768 UTF-8 bytes when present.
Defaults to false. When true, save the finalized setup after this message succeeds.
Requires message. Closing the browser does not cancel the save.
Response
Created or exact replay
Atomic draft creation response.
Explicit model for future messages.
Highest cancelled message sequence, as a decimal string.
Strong version for idle edits.
Private draft identity.
editing, saving or closed.
Human display title.
Latest accepted setup, absent before the first candidate.
Show child attributes
Show child attributes
Closing timestamp, such as 2026-10-24T05:00:00.000Z.
Private retention deadline, such as 2026-10-24T05:00:00.000Z.
Related fleet, when this draft targets or created one.
Explicit publication receipt, never synthesized by Save.
Show child attributes
Show child attributes
Complete effective setup, immutable requirements and live readiness.
Present only when creation accepted an initial message.
Show child attributes
Show child attributes