---
title: "POST /ace/{ace_uid}/jobs"
method: POST
path: "/ace/{ace_uid}/jobs"
tags: ["ace"]
---

# POST /ace/{ace_uid}/jobs

`POST /ace/{ace_uid}/jobs`

Enqueue a job against an ACE. Today: `regenerate` (playbook [re-]generation from the linked workforce's agent code file; the current playbook stays usable until the job commits a new one). The kind vocabulary grows server-side — future kinds include usage-driven adaptation.

## Path parameters

- `ace_uid` string, uuid, required

## Request body

- EnqueueAceJobReqBody — Request body for `POST /ace/{ace_uid}/jobs`. `kind` selects the work; the vocabulary lives in [`AceJobKind`] and grows server-side without new endpoints (usage-window adaptation, policy scaffolding, ...).
  - `app_id` integer, nullable — Disambiguates which linked workforce (`OrgsApps.id`) supplies the agent source when the ACE is attached to more than one. Optional when exactly one workforce is linked.
  - `kind` string, nullable — Job kind. Defaults to `"regenerate"` (playbook [re-]generation from the linked workforce's agent code file).
  - `rev` string, nullable — Git branch to read the agent source from. Defaults to the project repository's HEAD branch.

## Response `202`

Job enqueued

- EnqueueJobResBody — Response body returned by any endpoint that enqueues a new job. The HTTP status is `202 Accepted` — poll `GET /ace/{ace_uid}/jobs/{job_uid}` for terminal state.
  - `ace_uid` string, uuid, required
  - `job_uid` string, uuid, required
  - `kind` string, required — Job kind (e.g. `"generate_initial"`, `"regenerate"`).

## Other responses

- `400` — Bad request (e.g. unknown or non-enqueuable kind, unknown branch)
- `403` — Forbidden
- `404` — ACE not found, or no workforce linked
- `409` — ACE already has a queued or running job, or multiple linked workforces and no app_id

---

[API](https://skmtc.net/timbal-ai/apis/timbal-platform-api.md) · [All operations](https://skmtc.net/timbal-ai/apis/timbal-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timbal-ai/timbal-platform-api/revisions/dd7e398ce0d3/schema)