Rename a task

curl --request PUT \
  --url https://api.runaether.dev/v1/tasks/{taskID}/name \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

import requests

url = "https://api.runaether.dev/v1/tasks/{taskID}/name"

payload = { "name": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

fetch('https://api.runaether.dev/v1/tasks/{taskID}/name', 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.runaether.dev/v1/tasks/{taskID}/name",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>'
  ]),
  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.runaether.dev/v1/tasks/{taskID}/name"

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.runaether.dev/v1/tasks/{taskID}/name")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.runaether.dev/v1/tasks/{taskID}/name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "activity_items": [
    {
      "created_at": "<string>",
      "id": "<string>",
      "message": "<string>",
      "sequence": 4503599627370495,
      "task_id": "<string>",
      "type": "done",
      "event_id": "<string>"
    }
  ],
  "agent_type": "codex",
  "auto_fix_ci": true,
  "auto_fix_pr_comments": true,
  "auto_rebase": true,
  "base_branch": "<string>",
  "campaign": {
    "active_descendants": 1,
    "attention": "error",
    "descendants_merged": 1,
    "descendants_total": 2
  },
  "created_at": "<string>",
  "creator_reauth_required": true,
  "display_status": "running",
  "feed_updated_at": "<string>",
  "github_status": "approved",
  "hardware": {
    "cpu_kind": "shared",
    "cpus": 8,
    "gpu_kind": "a10",
    "memory_mb": 16512,
    "volume_size_gb": 250
  },
  "id": "<string>",
  "interaction_mode": "default",
  "latest_message_revision": 4503599627370495,
  "mcp_servers": [
    {
      "display_name": "<string>",
      "key": "<string>",
      "source": "catalog"
    }
  ],
  "model": "<string>",
  "name": "<string>",
  "org_id": "<string>",
  "parent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "post_pr_demo_video": true,
  "post_pr_screenshots": true,
  "pr_review_summary": {
    "comment_count": 1,
    "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "run_count": 2,
    "run_status": "reviewing",
    "severity_counts": {
      "confirmed": 1,
      "nit": 1,
      "p1": 1,
      "p2": 1,
      "question": 1
    },
    "summary_severity": "p1",
    "verdict": "APPROVE"
  },
  "primary_pull_request": {
    "additions": 1,
    "checks_failed": 1,
    "checks_passed": 1,
    "checks_total": 1,
    "commits": 1,
    "deletions": 1,
    "html_url": "<string>",
    "lines_changed": 1,
    "pr_number": 2,
    "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "branch_name": "<string>",
    "ci_status": "pending",
    "merged_at": "<string>",
    "state": "open"
  },
  "project": {
    "installation_id": 4503599627370496,
    "name": "<string>",
    "repo_url": "<string>",
    "state": "active"
  },
  "project_id": "<string>",
  "pull_requests": [
    {
      "additions": 1,
      "checks_failed": 1,
      "checks_passed": 1,
      "checks_total": 1,
      "commits": 1,
      "deletions": 1,
      "html_url": "<string>",
      "lines_changed": 1,
      "pr_number": 2,
      "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "branch_name": "<string>",
      "ci_status": "pending",
      "merged_at": "<string>",
      "state": "open"
    }
  ],
  "repo_mcp_server_notes": [
    "<string>"
  ],
  "repo_mcp_server_skips": [
    {
      "file": ".mcp.json",
      "reason": "<string>",
      "server": "<string>"
    }
  ],
  "review_subject_pull_request": {
    "additions": 1,
    "checks_failed": 1,
    "checks_passed": 1,
    "checks_total": 1,
    "commits": 1,
    "deletions": 1,
    "html_url": "<string>",
    "lines_changed": 1,
    "pr_number": 2,
    "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_trigger": "automatic",
    "title": "<string>",
    "branch_name": "<string>",
    "ci_status": "pending",
    "merged_at": "<string>",
    "origin_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_check_conclusion": "success",
    "state": "open"
  },
  "run_context": {
    "started_at": "<string>",
    "workspace_id": "<string>"
  },
  "runtime_timing": {
    "state": "inactive"
  },
  "source": "manual",
  "status": "queued",
  "url": "<string>",
  "usage": {
    "tokens_in": 4503599627370495,
    "tokens_out": 4503599627370495,
    "vm_uptime_seconds": 1
  },
  "user_id": "<string>",
  "agent_segments": [
    {
      "id": "<string>",
      "started_at": "<string>",
      "task_id": "<string>",
      "tokens_in": 1,
      "tokens_out": 1,
      "end_reason": "completed",
      "ended_at": "<string>"
    }
  ],
  "archived_at": "<string>",
  "head_branch": "<string>",
  "latest_status_message": "<string>",
  "latest_status_source": "<string>",
  "latest_workspace_warning": "<string>",
  "pinned_at": "<string>",
  "plan": {
    "completed": 1,
    "earlier_steps": [
      {
        "content": "<string>",
        "id": "<string>",
        "work": {
          "cloud_agent_task_ids": [
            "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          ],
          "ledger_tool_call_ids": [
            "<string>"
          ]
        }
      }
    ],
    "steps": [
      {
        "checks": [
          {
            "kind": "tests",
            "outcome": "passed"
          }
        ],
        "content": "<string>",
        "status": "pending",
        "work": {
          "cloud_agent_task_ids": [
            "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          ],
          "ledger_tool_call_ids": [
            "<string>"
          ]
        },
        "active_form": "<string>"
      }
    ],
    "total": 2,
    "unclaimed_work": {
      "cloud_agent_task_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "ledger_tool_call_ids": [
        "<string>"
      ]
    },
    "updated_at": "<string>",
    "current_step": "<string>",
    "explanation": "<string>"
  },
  "plan_progress": {
    "completed": 1,
    "total": 2,
    "current_step": "<string>"
  },
  "pr_review_mode": "review_only",
  "reasoning_effort": "ultra",
  "runtime_intervals": [
    {
      "id": "<string>",
      "machine_id": "<string>",
      "started_at": "<string>",
      "task_id": "<string>",
      "cpu_kind": "shared",
      "cpus": 1,
      "end_reason": "halted",
      "ended_at": "<string>",
      "gpu_kind": "a10",
      "memory_mb": 1,
      "volume_size_gb": 1,
      "workspace_id": "<string>"
    }
  ],
  "slash_commands": [
    {
      "description": "<string>",
      "name": "<string>",
      "input": {
        "hint": "<string>"
      }
    }
  ],
  "source_metadata": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

PUT

tasks

{taskID}

name

Rename a task

curl --request PUT \
  --url https://api.runaether.dev/v1/tasks/{taskID}/name \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

import requests

url = "https://api.runaether.dev/v1/tasks/{taskID}/name"

payload = { "name": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

fetch('https://api.runaether.dev/v1/tasks/{taskID}/name', 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.runaether.dev/v1/tasks/{taskID}/name",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>'
  ]),
  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.runaether.dev/v1/tasks/{taskID}/name"

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.runaether.dev/v1/tasks/{taskID}/name")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.runaether.dev/v1/tasks/{taskID}/name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "activity_items": [
    {
      "created_at": "<string>",
      "id": "<string>",
      "message": "<string>",
      "sequence": 4503599627370495,
      "task_id": "<string>",
      "type": "done",
      "event_id": "<string>"
    }
  ],
  "agent_type": "codex",
  "auto_fix_ci": true,
  "auto_fix_pr_comments": true,
  "auto_rebase": true,
  "base_branch": "<string>",
  "campaign": {
    "active_descendants": 1,
    "attention": "error",
    "descendants_merged": 1,
    "descendants_total": 2
  },
  "created_at": "<string>",
  "creator_reauth_required": true,
  "display_status": "running",
  "feed_updated_at": "<string>",
  "github_status": "approved",
  "hardware": {
    "cpu_kind": "shared",
    "cpus": 8,
    "gpu_kind": "a10",
    "memory_mb": 16512,
    "volume_size_gb": 250
  },
  "id": "<string>",
  "interaction_mode": "default",
  "latest_message_revision": 4503599627370495,
  "mcp_servers": [
    {
      "display_name": "<string>",
      "key": "<string>",
      "source": "catalog"
    }
  ],
  "model": "<string>",
  "name": "<string>",
  "org_id": "<string>",
  "parent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "post_pr_demo_video": true,
  "post_pr_screenshots": true,
  "pr_review_summary": {
    "comment_count": 1,
    "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "run_count": 2,
    "run_status": "reviewing",
    "severity_counts": {
      "confirmed": 1,
      "nit": 1,
      "p1": 1,
      "p2": 1,
      "question": 1
    },
    "summary_severity": "p1",
    "verdict": "APPROVE"
  },
  "primary_pull_request": {
    "additions": 1,
    "checks_failed": 1,
    "checks_passed": 1,
    "checks_total": 1,
    "commits": 1,
    "deletions": 1,
    "html_url": "<string>",
    "lines_changed": 1,
    "pr_number": 2,
    "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "branch_name": "<string>",
    "ci_status": "pending",
    "merged_at": "<string>",
    "state": "open"
  },
  "project": {
    "installation_id": 4503599627370496,
    "name": "<string>",
    "repo_url": "<string>",
    "state": "active"
  },
  "project_id": "<string>",
  "pull_requests": [
    {
      "additions": 1,
      "checks_failed": 1,
      "checks_passed": 1,
      "checks_total": 1,
      "commits": 1,
      "deletions": 1,
      "html_url": "<string>",
      "lines_changed": 1,
      "pr_number": 2,
      "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "branch_name": "<string>",
      "ci_status": "pending",
      "merged_at": "<string>",
      "state": "open"
    }
  ],
  "repo_mcp_server_notes": [
    "<string>"
  ],
  "repo_mcp_server_skips": [
    {
      "file": ".mcp.json",
      "reason": "<string>",
      "server": "<string>"
    }
  ],
  "review_subject_pull_request": {
    "additions": 1,
    "checks_failed": 1,
    "checks_passed": 1,
    "checks_total": 1,
    "commits": 1,
    "deletions": 1,
    "html_url": "<string>",
    "lines_changed": 1,
    "pr_number": 2,
    "pull_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_trigger": "automatic",
    "title": "<string>",
    "branch_name": "<string>",
    "ci_status": "pending",
    "merged_at": "<string>",
    "origin_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_check_conclusion": "success",
    "state": "open"
  },
  "run_context": {
    "started_at": "<string>",
    "workspace_id": "<string>"
  },
  "runtime_timing": {
    "state": "inactive"
  },
  "source": "manual",
  "status": "queued",
  "url": "<string>",
  "usage": {
    "tokens_in": 4503599627370495,
    "tokens_out": 4503599627370495,
    "vm_uptime_seconds": 1
  },
  "user_id": "<string>",
  "agent_segments": [
    {
      "id": "<string>",
      "started_at": "<string>",
      "task_id": "<string>",
      "tokens_in": 1,
      "tokens_out": 1,
      "end_reason": "completed",
      "ended_at": "<string>"
    }
  ],
  "archived_at": "<string>",
  "head_branch": "<string>",
  "latest_status_message": "<string>",
  "latest_status_source": "<string>",
  "latest_workspace_warning": "<string>",
  "pinned_at": "<string>",
  "plan": {
    "completed": 1,
    "earlier_steps": [
      {
        "content": "<string>",
        "id": "<string>",
        "work": {
          "cloud_agent_task_ids": [
            "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          ],
          "ledger_tool_call_ids": [
            "<string>"
          ]
        }
      }
    ],
    "steps": [
      {
        "checks": [
          {
            "kind": "tests",
            "outcome": "passed"
          }
        ],
        "content": "<string>",
        "status": "pending",
        "work": {
          "cloud_agent_task_ids": [
            "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          ],
          "ledger_tool_call_ids": [
            "<string>"
          ]
        },
        "active_form": "<string>"
      }
    ],
    "total": 2,
    "unclaimed_work": {
      "cloud_agent_task_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "ledger_tool_call_ids": [
        "<string>"
      ]
    },
    "updated_at": "<string>",
    "current_step": "<string>",
    "explanation": "<string>"
  },
  "plan_progress": {
    "completed": 1,
    "total": 2,
    "current_step": "<string>"
  },
  "pr_review_mode": "review_only",
  "reasoning_effort": "ultra",
  "runtime_intervals": [
    {
      "id": "<string>",
      "machine_id": "<string>",
      "started_at": "<string>",
      "task_id": "<string>",
      "cpu_kind": "shared",
      "cpus": 1,
      "end_reason": "halted",
      "ended_at": "<string>",
      "gpu_kind": "a10",
      "memory_mb": 1,
      "volume_size_gb": 1,
      "workspace_id": "<string>"
    }
  ],
  "slash_commands": [
    {
      "description": "<string>",
      "name": "<string>",
      "input": {
        "hint": "<string>"
      }
    }
  ],
  "source_metadata": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

taskID

string<uuid>

required

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json

name

string

required

The task's name: one line of at most 200 characters (Unicode code points), without control characters or leading or trailing whitespace.

Minimum string length: 1

Response

Option 1
Option 2
Option 3
Option 4

activity_items

object[]

required

Show child attributes

agent_type

enum<string>

required

Available options:

codex,

claude-code,

opencode

auto_fix_ci

boolean

required

auto_fix_pr_comments

boolean

required

auto_rebase

boolean

required

base_branch

string

required

Minimum string length: 1

Pattern: \S

campaign

object | null

required

Show child attributes

created_at

string

required

Minimum string length: 1

creator_reauth_required

boolean

required

display_status

enum<string>

required

Available options:

running,

awaiting_input,

approved,

awaiting_ci,

merged,

unmerged,

errored,

archived

feed_updated_at

string

required

Minimum string length: 1

github_status

enum<string> | null

required

Available options:

approved,

merged,

unmerged,

awaiting_ci

hardware

object

required

Show child attributes

string

required

Minimum string length: 1

interaction_mode

enum<string>

required

Available options:

default,

plan

latest_message_revision

integer<int64>

required

Maximum revision_sequence of currently stored task messages, including soft-deleted rows; zero means no messages. Compare equality only: hard deletion can decrease it. Not an activity/stream cursor or a task-wide version.

Required range: 0 <= x <= 9007199254740991

mcp_servers

object[]

required

Option 1
Option 2

Show child attributes

model

string

required

Minimum string length: 1

name

string

required

Minimum string length: 1

org_id

string

required

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

parent_task_id

string<uuid> | null

required

post_pr_demo_video

boolean

required

post_pr_screenshots

boolean

required

pr_review_summary

object | null

required

Show child attributes

primary_pull_request

object | null

required

Show child attributes

project

object

required

Option 1
Option 2

Show child attributes

project_id

string

required

Minimum string length: 1

pull_requests

object[]

required

Show child attributes

repo_mcp_server_notes

string[]

required

Minimum string length: 1

repo_mcp_server_skips

object[]

required

Show child attributes

review_subject_pull_request

object | null

required

Show child attributes

run_context

object | null

required

Show child attributes

runtime_timing

object

required

Option 1
Option 2

Show child attributes

source

enum<string>

required

Available options:

manual,

web,

mobile,

cli,

ci,

sentry,

linear,

slack,

automation,

pr_review,

teleport,

agent,

delegation

status

enum<string>

required

Available options:

queued

url

string<uri>

required

The task's page in the Aether web app.

Minimum string length: 1

usage

object

required

Show child attributes

user_id

string | null

required

Minimum string length: 1

agent_segments

object[]

Show child attributes

archived_at

string | null

Minimum string length: 1

head_branch

string

Minimum string length: 1

latest_status_message

string | null

latest_status_source

string | null

latest_workspace_warning

string

Minimum string length: 1

pinned_at

string | null

Minimum string length: 1

plan

object

Show child attributes

plan_progress

object

Show child attributes

pr_review_mode

enum<string> | null

Available options:

review_only,

fix_on_request,

apply_fixes

reasoning_effort

enum<string> | null

Available options:

ultra,

max,

xhigh,

high,

medium,

low,

ultrathink,

ultracode

runtime_intervals

object[]

Show child attributes

slash_commands

object[] | null

Show child attributes

source_metadata

object | null

API Reference

Projects

Workspaces

Tasks

Environment Variables

Secret Files

Skills

Automations

Agent Profiles

MCP Servers

Plugins

Usage

Profile

Organizations

User Discovery

Pr Reviews

Pull Requests

Push Tokens

Agent

Connections

Slack

Sentry

Feedback

Notifications

GitHub

Platform API Keys

User Settings

Billing

Linear

WebSocket

Rename a task

Authorizations

Path Parameters

Body

Response