Submit a task
Queues fire-and-forget macOS work: a Mac slot clones repo (git clone --depth 1 of the default branch), runs command (or the agent program, for kind: agent) as zsh -lc in the clone with CI=1, uploads the promised artifacts, and reports the outcome. The task’s worst case (timeoutMs at the hourly price) is reserved against the credit and the budget until it ends; time spent queued is free. A team may have at most 16 tasks waiting and 4 claimed or running at once; free slots go first to the team with the fewest tasks running, so one team’s backlog never holds another’s work behind it. A finished task is kept for 30 days (fewer when the team’s finished tasks pass 4 MiB of records, oldest first), then GET /v1/tasks/{taskId} is 404.
Authorizations
Headers
Any unique string. A retry with the same key and body within 24 hours answers 201 with what the first request made, as it is now, instead of creating again, including after a plane restart; the same key with a different body is 409 idempotency-key-reused. Failures are not remembered. Scoped to the team and the route.
1 - 255Body
Unknown fields are refused with 400 unknown-field.
File names in the clone's root that the task promises to upload; nothing else is kept. A name is 1 to 128 letters, digits, ., _ and -, starts with a letter or digit, has no .. and does not end in .meta.json. If the command exits 0, every promised artifact must exist and be non-empty. One artifact is at most 100 MiB, a task's together at most 256 MiB, and a team's stored artifacts at most 512 MiB; past any of those, or when the plane's artifact storage is full, the upload is refused with 413 artifact-quota, whose message names the share. Artifacts are deleted 7 days after their task ends.
32^(?!.*\.\.)(?!.*\.meta\.json$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$How long it may wait for a slot before failing with failureReason: no-capacity. 15 minutes by default. A team runs 4 tasks at once, and time spent behind the team's own earlier tasks while it has those 4 running does not count: the wait counts from the last moment the team held it back.
1 <= x <= 86400000Response
The task, in state queued. A replay of an earlier create with the same Idempotency-Key and body answers 201 with that task as it is now (the same id, in its current state), with idempotent-replayed: true.
A task. Fields that do not apply yet (boxId, slot, startedAt, endedAt, runtimeSeconds) are absent, not null.