ace

Changed on

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.

post/ace/{ace_uid}/jobs

Request

  • Base URL
    https://api.timbal.ai
  • URL
    https://api.timbal.ai/ace/{ace_uid}/jobs
  • Auth
    HTTP bearer

Path parameters

ace_uidstring uuid required

ACE uid (UUID).

Request body

app_idinteger 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.

kindstring nullable

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

revstring nullable

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

Response

Job enqueued

ace_uidstring uuid required
job_uidstring uuid required
kindstring required

Job kind (e.g. "generate_initial", "regenerate").

Changes