CreateWorkstreamAPI mirrors erdo_create_workstream.
curl --request POST \
--url https://api.erdo.ai/v1/workstreams \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "<string>",
"phases": [
{
"skill_slug": "<string>",
"slug": "<string>",
"title": "<string>"
}
],
"project_slug": "<string>",
"slug": "<string>",
"title": "<string>",
"token_budget_millicents": 123
}
'import requests
url = "https://api.erdo.ai/v1/workstreams"
payload = {
"description": "<string>",
"phases": [
{
"skill_slug": "<string>",
"slug": "<string>",
"title": "<string>"
}
],
"project_slug": "<string>",
"slug": "<string>",
"title": "<string>",
"token_budget_millicents": 123
}
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({
description: '<string>',
phases: [{skill_slug: '<string>', slug: '<string>', title: '<string>'}],
project_slug: '<string>',
slug: '<string>',
title: '<string>',
token_budget_millicents: 123
})
};
fetch('https://api.erdo.ai/v1/workstreams', 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.erdo.ai/v1/workstreams",
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([
'description' => '<string>',
'phases' => [
[
'skill_slug' => '<string>',
'slug' => '<string>',
'title' => '<string>'
]
],
'project_slug' => '<string>',
'slug' => '<string>',
'title' => '<string>',
'token_budget_millicents' => 123
]),
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.erdo.ai/v1/workstreams"
payload := strings.NewReader("{\n \"description\": \"<string>\",\n \"phases\": [\n {\n \"skill_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"project_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\",\n \"token_budget_millicents\": 123\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.erdo.ai/v1/workstreams")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"<string>\",\n \"phases\": [\n {\n \"skill_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"project_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\",\n \"token_budget_millicents\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/workstreams")
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 \"description\": \"<string>\",\n \"phases\": [\n {\n \"skill_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"project_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\",\n \"token_budget_millicents\": 123\n}"
response = http.request(request)
puts response.read_body{
"assignments": [
{
"acceptance_criteria": "<string>",
"adoption_state": "<string>",
"assigned_agent_key": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"expected_result_kind": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"latest_attempt": {
"agent_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"attempt_number": 123,
"ended_at": "2023-11-07T05:31:56Z",
"handles": [
{
"resource_id": "<string>",
"resource_type": "<string>",
"revision_ref": "<string>"
}
],
"result_kind": "<string>",
"state": "<string>",
"summary": "<string>",
"terminal_reason": "<string>"
},
"objective": "<string>",
"reason": "<string>",
"slug": "<string>",
"work_state": "<string>",
"work_state_reason": "<string>"
}
],
"current_decisions": [
{
"applicability": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"authorized_at": "2023-11-07T05:31:56Z",
"decided_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"decider_kind": "<string>",
"decider_rationale": "<string>",
"decision_class": "<string>",
"evidence_kind": "<string>",
"execution_status": "<string>",
"outcome_label": "<string>",
"outcome_status": "<string>",
"proposed_at": "2023-11-07T05:31:56Z",
"rejected_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"source": "<string>",
"status": "<string>",
"subject_kind": "<string>",
"subject_label": "<string>",
"superseded_by_decision_slug": "<string>",
"supersedes_decision_slug": "<string>",
"what": "<string>",
"why": "<string>"
}
],
"events": [
{
"actor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"actor_type": "<string>",
"body": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"following": true,
"phases": [
{
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"skill_slug": "<string>",
"slug": "<string>",
"sort_order": -1,
"started_at": "2023-11-07T05:31:56Z",
"status": "<string>",
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"recent_decisions": [
{
"applicability": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"authorized_at": "2023-11-07T05:31:56Z",
"decided_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"decider_kind": "<string>",
"decider_rationale": "<string>",
"decision_class": "<string>",
"evidence_kind": "<string>",
"execution_status": "<string>",
"outcome_label": "<string>",
"outcome_status": "<string>",
"proposed_at": "2023-11-07T05:31:56Z",
"rejected_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"source": "<string>",
"status": "<string>",
"subject_kind": "<string>",
"subject_label": "<string>",
"superseded_by_decision_slug": "<string>",
"supersedes_decision_slug": "<string>",
"what": "<string>",
"why": "<string>"
}
],
"resources": [
{
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"phase_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"relationship_type": "<string>",
"resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"resource_type": "<string>",
"title": "<string>",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"workstream": {
"autonomy_mode": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"escalation_budget_per_day": -1,
"external_refs": [
{
"account_id": "<string>",
"external_id": "<string>",
"kind": "<string>",
"label": "<string>",
"provider": "<string>"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"primary_thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revision": 123,
"slug": "<string>",
"source_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"spent_millicents": 123,
"started_at": "2023-11-07T05:31:56Z",
"status": "<string>",
"title": "<string>",
"token_budget_millicents": 123,
"updated_at": "2023-11-07T05:31:56Z"
}
}{
"code": "not_found",
"details": {},
"message": "<string>"
}API Reference
CreateWorkstreamAPI mirrors erdo_create_workstream.
POST
/
v1
/
workstreams
CreateWorkstreamAPI mirrors erdo_create_workstream.
curl --request POST \
--url https://api.erdo.ai/v1/workstreams \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "<string>",
"phases": [
{
"skill_slug": "<string>",
"slug": "<string>",
"title": "<string>"
}
],
"project_slug": "<string>",
"slug": "<string>",
"title": "<string>",
"token_budget_millicents": 123
}
'import requests
url = "https://api.erdo.ai/v1/workstreams"
payload = {
"description": "<string>",
"phases": [
{
"skill_slug": "<string>",
"slug": "<string>",
"title": "<string>"
}
],
"project_slug": "<string>",
"slug": "<string>",
"title": "<string>",
"token_budget_millicents": 123
}
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({
description: '<string>',
phases: [{skill_slug: '<string>', slug: '<string>', title: '<string>'}],
project_slug: '<string>',
slug: '<string>',
title: '<string>',
token_budget_millicents: 123
})
};
fetch('https://api.erdo.ai/v1/workstreams', 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.erdo.ai/v1/workstreams",
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([
'description' => '<string>',
'phases' => [
[
'skill_slug' => '<string>',
'slug' => '<string>',
'title' => '<string>'
]
],
'project_slug' => '<string>',
'slug' => '<string>',
'title' => '<string>',
'token_budget_millicents' => 123
]),
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.erdo.ai/v1/workstreams"
payload := strings.NewReader("{\n \"description\": \"<string>\",\n \"phases\": [\n {\n \"skill_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"project_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\",\n \"token_budget_millicents\": 123\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.erdo.ai/v1/workstreams")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"<string>\",\n \"phases\": [\n {\n \"skill_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"project_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\",\n \"token_budget_millicents\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/workstreams")
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 \"description\": \"<string>\",\n \"phases\": [\n {\n \"skill_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"project_slug\": \"<string>\",\n \"slug\": \"<string>\",\n \"title\": \"<string>\",\n \"token_budget_millicents\": 123\n}"
response = http.request(request)
puts response.read_body{
"assignments": [
{
"acceptance_criteria": "<string>",
"adoption_state": "<string>",
"assigned_agent_key": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"expected_result_kind": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"latest_attempt": {
"agent_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"attempt_number": 123,
"ended_at": "2023-11-07T05:31:56Z",
"handles": [
{
"resource_id": "<string>",
"resource_type": "<string>",
"revision_ref": "<string>"
}
],
"result_kind": "<string>",
"state": "<string>",
"summary": "<string>",
"terminal_reason": "<string>"
},
"objective": "<string>",
"reason": "<string>",
"slug": "<string>",
"work_state": "<string>",
"work_state_reason": "<string>"
}
],
"current_decisions": [
{
"applicability": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"authorized_at": "2023-11-07T05:31:56Z",
"decided_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"decider_kind": "<string>",
"decider_rationale": "<string>",
"decision_class": "<string>",
"evidence_kind": "<string>",
"execution_status": "<string>",
"outcome_label": "<string>",
"outcome_status": "<string>",
"proposed_at": "2023-11-07T05:31:56Z",
"rejected_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"source": "<string>",
"status": "<string>",
"subject_kind": "<string>",
"subject_label": "<string>",
"superseded_by_decision_slug": "<string>",
"supersedes_decision_slug": "<string>",
"what": "<string>",
"why": "<string>"
}
],
"events": [
{
"actor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"actor_type": "<string>",
"body": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"following": true,
"phases": [
{
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"skill_slug": "<string>",
"slug": "<string>",
"sort_order": -1,
"started_at": "2023-11-07T05:31:56Z",
"status": "<string>",
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"recent_decisions": [
{
"applicability": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"authorized_at": "2023-11-07T05:31:56Z",
"decided_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"decider_kind": "<string>",
"decider_rationale": "<string>",
"decision_class": "<string>",
"evidence_kind": "<string>",
"execution_status": "<string>",
"outcome_label": "<string>",
"outcome_status": "<string>",
"proposed_at": "2023-11-07T05:31:56Z",
"rejected_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"source": "<string>",
"status": "<string>",
"subject_kind": "<string>",
"subject_label": "<string>",
"superseded_by_decision_slug": "<string>",
"supersedes_decision_slug": "<string>",
"what": "<string>",
"why": "<string>"
}
],
"resources": [
{
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"phase_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"relationship_type": "<string>",
"resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"resource_type": "<string>",
"title": "<string>",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"workstream": {
"autonomy_mode": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"escalation_budget_per_day": -1,
"external_refs": [
{
"account_id": "<string>",
"external_id": "<string>",
"kind": "<string>",
"label": "<string>",
"provider": "<string>"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"primary_thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revision": 123,
"slug": "<string>",
"source_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"spent_millicents": 123,
"started_at": "2023-11-07T05:31:56Z",
"status": "<string>",
"title": "<string>",
"token_budget_millicents": 123,
"updated_at": "2023-11-07T05:31:56Z"
}
}{
"code": "not_found",
"details": {},
"message": "<string>"
}Authorizations
An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).
Body
application/json
Show child attributes
Show child attributes
workstream armed with a loop starts spending on its first pass, and until this field existed the only way to set an envelope through the API was to create the workstream and then PATCH it.
Response
Success response
coordinator and Studio. It carries responsibility, execution, submission, and adoption as separate facts; callers must not infer work state from an agent transcript or collapse a proposed result into an accepted one.
Show child attributes
Show child attributes
agent receives, on the same read: standing commitments and in-flight authorizations, then the history around them. The operator returning to a workstream and the agent continuing it are answering the same question — what are we operating under? — and a detail page that had to derive its own answer would be a second copy free to disagree with the one steering the work.
Show child attributes
Show child attributes
(newest first), embedded so cards/agents see activity without a second call.
Show child attributes
Show child attributes
detail page can render its follow toggle without a second call (Wave E).
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Operational state machine for multi-step work (campaign launches, reports, monitors).
Show child attributes
Show child attributes