Tasks-3
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
GET | |
GET | |
GET | |
POST |
Retrieve tasks runs stream
API for managing task runs. Each run represents an execution of a task.
Required API key scopes
task:readPath parameters
- idstring
- task_idstring
Example request
GET /api /projects /:project_id /tasks /:task_id /runs /:id /streamExample response
Status 200
Retrieve tasks repositories
Return the set of repositories referenced by non-deleted, non-internal tasks in the current project. Used to populate repository filter pickers without being constrained by task list pagination.
Required API key scopes
task:readResponse
Example request
GET /api /projects /:project_id /tasks /repositoriesExample response
Status 200 Distinct repositories used by tasks in the current project.
Retrieve tasks repositories
Return the set of repositories referenced by non-deleted, non-internal tasks in the current project. Used to populate repository filter pickers without being constrained by task list pagination.
Required API key scopes
task:readResponse
Example request
GET /api /projects /:project_id /tasks /repositoriesExample response
Status 200 Distinct repositories used by tasks in the current project.
Retrieve tasks repository readiness
Get autonomy readiness details for a specific repository in the current project.
Required API key scopes
task:readQuery parameters
- refreshbooleanDefault:
false - repositorystring
- window_daysintegerDefault:
7
Response
Example request
GET /api /projects /:project_id /tasks /repository_readinessExample response
Status 200 Repository readiness status
Retrieve tasks repository readiness
Get autonomy readiness details for a specific repository in the current project.
Required API key scopes
task:readQuery parameters
- refreshbooleanDefault:
false - repositorystring
- window_daysintegerDefault:
7
Response
Example request
GET /api /projects /:project_id /tasks /repository_readinessExample response
Status 200 Repository readiness status
Create tasks summaries
Returns summary for the requested tasks: id, title, repository, created_at, updated_at, and the latest run's status and environment.
Required API key scopes
task:readQuery parameters
- limitinteger
- offsetinteger
Request parameters
- idsarray
Response
Example request
POST /api /projects /:project_id /tasks /summariesExample response
Status 200 Summary fields for the requested tasks
Create tasks summaries
Returns summary for the requested tasks: id, title, repository, created_at, updated_at, and the latest run's status and environment.
Required API key scopes
task:readQuery parameters
- limitinteger
- offsetinteger
Request parameters
- idsarray
Response
Example request
POST /api /projects /:project_id /tasks /summaries