Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

ace_uid
string<uuid>
required

ACE uid (UUID).

Body

application/json

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<int64> | null

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 | null

Job kind. Defaults to "regenerate" (playbook [re-]generation from the linked workforce's agent code file).

rev
string | null

Git branch to read the agent source from. Defaults to the project repository's HEAD branch.

Response

Job enqueued

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").