Tasks
Last updated
Last updated
Retrieves the current status of a task including progress percentage, current step, and completion status. Use this endpoint to poll for task completion. Status values include: pending, active, completed, failed, cancelled.
The task status has been successfully retrieved.
Retrieves the final result of a completed task. Returns error details if the task failed. Results are retained for a limited time after completion. For recurring tasks, this returns the result of the most recent execution.
The task result has been successfully retrieved.
Cancels a pending or active task. Completed tasks cannot be cancelled. For recurring tasks, this cancels the current execution but does not prevent future executions - use stop-recurring endpoint instead. Cancellation may not be immediate for actively running tasks.
The task has been successfully cancelled.
Stops a recurring task and prevents any future executions. Does not affect already completed executions.
The ID of the recurring task to stop
123e4567-e89b-12d3-a456-426614174000
Retrieves execution history for a recurring task including all past instances. Each instance shows its execution time, status, and result. Useful for monitoring recurring task performance and debugging issues. Returns empty array for non-recurring tasks.
List of all instances of the recurring task
Submits a new task for asynchronous execution. Tasks can be one-time, delayed, or recurring. Supported task types include review environment operations (fetch, check, transition, list, unassign). Returns an operation ID that can be used to track task progress and retrieve results.
The type of task to be executed
fetchReviewEnvironment
Possible values: The data required for the task
{"value":{"repoId":"repo123","directory":"/path/to/dir","username":"user@devhub.ocom","pool":"core","pooltype":"sandbox","branch":"feature/123","issue":"ISSUE-123","wait":300,"leasefor":3600},"description":"Fetch a review environment"}
Lock duration in milliseconds (default: 300000 - 5 minutes)
300000
Type of task priority
low
Possible values: Type of task scheduling
immediate
Possible values: Scheduled execution time for one-time scheduled tasks
2024-10-27T10:00:00Z
Retry configuration for this task
Configuration for recurring tasks
The task has been successfully created.