GetAttempt
Returns an attempt's identity, status, timestamps, and sandbox/session IDs, with parent run, workflow, and job context.
Request
- Base URLhttps://api.depot.dev
- AuthHTTP bearer
Headers
Define the version of the Connect protocol
Define the timeout, in ms
Request body
Unique identifier for the job attempt. Returned by GetRunStatus, GetWorkflow, and GetJob.
Response
Success
Depot organization that owns this attempt.
Unique identifier for the parent CI run.
GitHub repository in owner/name format. For example, "depot/cli".
Git ref the parent run was triggered against. Empty when the trigger carries no ref.
Commit SHA the parent run executes against. For pull_request triggers, the merge commit SHA.
Source commit SHA for pull_request and merge_group triggers. Empty for triggers that don't carry a head SHA.
Event that triggered the parent run. For example, "push", "pull_request", "pull_request_target", "issue_comment", "merge_group", "schedule", "workflow_run", or "workflow_dispatch".
Current state of the parent run. Can be "queued", "running", "finished", "failed", or "cancelled".
Parent run creation time, in RFC 3339 format.
Parent run start time, in RFC 3339 format. Empty until the run starts.
Parent run finish time, in RFC 3339 format. Empty until the run finishes.
Unique identifier for the parent workflow.
Parent workflow name from the YAML name: key. Falls back to the file path stem when the workflow doesn't set name:. Empty when neither is available.
Parent workflow file path. For example, ".depot/workflows/ci.yml". Empty when the workflow YAML was passed via workflowContent in the Run request.
Current state of the parent workflow. Can be "queued", "running", "finished", "failed", or "cancelled".
Parent workflow error or cancellation reason. For example, a compilation or validation error. Empty when the workflow is healthy.
Parent workflow creation time, in RFC 3339 format.
Parent workflow start time, in RFC 3339 format. Empty until the workflow starts.
Parent workflow finish time, in RFC 3339 format. Empty until the workflow finishes.
Unique identifier for the parent job.
Parent job key from the workflow. For example, "build" or "test".
Human-readable display name for the parent job. Falls back to jobKey when no display name is set.
Current state of the parent job. Can be "queued", "waiting", "running", "finished", "failed", "cancelled", or "skipped". "waiting" means the job is blocked behind another run that holds the same concurrency: group slot.
Conclusion of the parent job. Can be "success", "failure", "cancelled", "skipped", or "timed_out". Empty until the job concludes.
Parent job error message populated for orchestration or worker failures. Empty when the job has no error.
Parent job creation time, in RFC 3339 format.
Parent job dispatch time, in RFC 3339 format. Empty until the job is dispatched to a worker.
Parent job start time, in RFC 3339 format. Empty until the job starts.
Parent job finish time, in RFC 3339 format. Empty until the job finishes.
Unique identifier for the parent job's most recent attempt. Equals attempt.attemptId when this is the current attempt.
Most recent attempt number for the parent job. Equals attempt.attempt when this is the current attempt.
Changes
No recorded changes to this operation across all 1 revision of this API.