How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Coder Tasks API

The Tasks API from Coder — 9 operation(s) for tasks.

Coder Tasks API is one of 32 APIs that Coder publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 10 operations across 9 paths, and defines 45 schemas. It is described by OpenAPI 3.2.0, at version 2.0.

Requests are made against a single base URL, https://{coderHost}/api/v2.

10 operations 9 paths 45 schemas 1 DELETE3 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0
Base URL
https://coder.example.com/api/v2
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Coder Tasks API declares 1 security scheme for authenticating requests. An API key is passed in the header as Coder-Session-Token (CoderSessionToken). By default, every request must be authenticated.

Paths & Operations 10

Across 9 paths, the API surfaces 10 operations — 1 DELETE, 3 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Tasks 10
GET
/api/v2/tasks
List AI tasks
list-ai-tasks 1 param → 200
POST
/api/v2/tasks/{user}
Create a new AI task
create-a-new-ai-task 1 param body → 201
GET
/api/v2/tasks/{user}/{task}
Get AI task by ID or name
get-ai-task-by-id-or-name 2 params → 200
DELETE
/api/v2/tasks/{user}/{task}
Delete AI task
delete-ai-task 2 params → 202
PATCH
/api/v2/tasks/{user}/{task}/input
Update AI task input
update-ai-task-input 2 params body → 204
GET
/api/v2/tasks/{user}/{task}/logs
Get AI task logs
get-ai-task-logs 2 params → 200
POST
/api/v2/tasks/{user}/{task}/pause
Pause task
pause-task 2 params → 202
POST
/api/v2/tasks/{user}/{task}/resume
Resume task
resume-task 2 params → 202
POST
/api/v2/tasks/{user}/{task}/send
Send input to AI task
send-input-to-ai-task 2 params body → 204
POST
/api/v2/workspaceagents/me/tasks/{task}/log-snapshot
Upload task log snapshot
upload-task-log-snapshot 2 params body → 204

Schemas 45

The contract defines 45 schemas that model the data the API accepts and returns. The most detailed are codersdk.WorkspaceAgent (33 properties), codersdk.Task (25 properties), codersdk.WorkspaceBuild (25 properties), codersdk.ProvisionerJob (21 properties). Each schema is shown below with its type and property counts.

codersdk.TaskLogEntry
object
4 properties
codersdk.TaskSendRequest
object
1 property
codersdk.ProvisionerJob
object
21 properties
codersdk.AgentSubsystem
string
codersdk.WorkspaceAppStatus
object
10 properties
codersdk.ProvisionerJobMetadata
object
8 properties
codersdk.PauseTaskResponse
object
1 property
codersdk.TaskState
string
codersdk.WorkspaceAgentHealth
object
2 properties
codersdk.WorkspaceTransition
string
codersdk.WorkspaceAgentScriptStatus
string
codersdk.WorkspaceResource
object
11 properties
codersdk.WorkspaceAgentStartupScriptBehavior
string
codersdk.Healthcheck
object
3 properties
codersdk.WorkspaceAgentStatus
string
codersdk.CreateTaskRequest
object
5 properties
codersdk.TaskStatus
string
codersdk.JobErrorCode
string
codersdk.ResumeTaskResponse
object
1 property
codersdk.WorkspaceAppStatusState
string
codersdk.WorkspaceResourceMetadata
object
3 properties
codersdk.WorkspaceAgentLogSource
object
5 properties
codersdk.DisplayApp
string
codersdk.MatchedProvisioners
object
3 properties
codersdk.WorkspaceApp
object
17 properties
codersdk.ProvisionerJobStatus
string
codersdk.ProvisionerJobType
string
codersdk.WorkspaceAgentLifecycle
string
codersdk.TaskLogsResponse
object
3 properties
codersdk.Task
object
25 properties
codersdk.TaskLogType
string
codersdk.WorkspaceAppOpenIn
string
codersdk.ProvisionerJobInput
object
3 properties
codersdk.TasksListResponse
object
2 properties
uuid.NullUUID
object
2 properties
codersdk.UpdateTaskInputRequest
object
1 property
codersdk.TaskStateEntry
object
4 properties
codersdk.WorkspaceAgentScript
object
12 properties
codersdk.WorkspaceAgent
object
33 properties
codersdk.WorkspaceAppHealth
string
codersdk.WorkspaceBuild
object
25 properties
codersdk.BuildReason
string
codersdk.WorkspaceAppSharingLevel
string
codersdk.WorkspaceStatus
string
codersdk.DERPRegion
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

coder-tasks-api-openapi.yml Raw ↑

Other APIs Coder publishes across the network.

Coder Workspaces API
Coder Templates API
Coder Users API
Coder Workspace Agents API
Coder Enterprise API
Coder Agents API
Coder AI Bridge API
Coder AI Providers API
Coder Applications API
Coder Audit API
Coder Authorization API
Coder Builds API
Where this information came from

This is an independent, third-party profile of Coder Tasks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.