List tasks
const url = 'https://example.com/api/v1/org/example/tasks?sort_by=name&sort_dir=asc&page=1&limit=50&include_public=false';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/api/v1/org/example/tasks?sort_by=name&sort_dir=asc&page=1&limit=50&include_public=false' \ --header 'Authorization: Bearer <token>'List tasks the user has access to (one per name, latest version)
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Organization slug
Organization slug
Query Parameters
Section titled “Query Parameters ”Column to sort by
Column to sort by
Sort direction
Sort direction
Page number
Page number
Items per page
Items per page
Include public tasks from other orgs
Include public tasks from other orgs
Responses
Section titled “ Responses ”Successful Response
Paginated task list response.
object
Whether a next page exists
Whether a previous page exists
Maximum items per page
Current page number (1-indexed)
List of tasks
Summary of a task for list responses
object
Creation timestamp
Task archive file size in bytes
Task ID
Whether the task is publicly visible
Task name
Owning organization key
Organization ID
Sandbox provider (docker or e2b)
Template building status
Verification configuration for task results.
Accepts legacy keys flag_hash and submission_path as input aliases
for hash and path so older task.yaml files keep importing.
object
Inline config for an outcome_judge verification with kind=trajectory.
Mirrors the SDK CLI’s TrajectoryJudgeConfig shape exactly (the platform
serializes this to JSON and hands it to dn judge outcome --config).
Wire-compatible with the SDK; any field added one side must be added on
the other.
object
Maximum judge-agent steps before MaxStepsExhausted.
Generator identifier for the judge.
Generator params passed through.
object
Opaque dict surfaced to the judge as additional context.
object
Verification timeout in seconds
Where the verification script runs (method: script only).
Task version
Total items matching the query
Total number of pages
Example
{ "tasks": [ { "sandbox_provider": "e2b", "template_status": "pending", "verification": { "judge": { "kind": "trajectory", "max_steps": 50 }, "method": "script", "timeout": 30, "where": "agent" } } ]}Invalid request
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Authentication failed
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Access forbidden
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Not found
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Already exists
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Validation error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Upgrade required
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Rate limited
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Internal server error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Bad gateway
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Gateway timeout
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}