Skip to main content
POST
/
orgs
/
{org_id}
/
projects
/
{project_id}
/
workforce
/
{workforce}
/
ace
cURL
curl --request POST \
  --url https://api.timbal.ai/orgs/{org_id}/projects/{project_id}/workforce/{workforce}/ace \
  --header 'Authorization: Bearer <token>'
{
  "ace_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "job_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
org_id
string
required

Organization id

​
project_id
string
required

Project id

​
workforce
string
required

Workforce component: numeric id, manifest UUID, or name

Query Parameters

​
rev
string
required

Git branch name (for example main).

Response

ACE created; generation 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").