Skip to main content
GET
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

org_id
string
required
project_id
string
required
env_id
string
required

Query Parameters

component_id
string | null

Filter to a single workforce component by its numeric app id (the value the SDK reads from TIMBAL_APP_ID, also returned as id on each deployment in the response). Combines with component_uid: when both are set, rows must match both.

component_uid
string | null

Filter to a single workforce component by its manifest uid (the _id field in timbal.yaml, also returned as uid on each deployment in the response). Display name is deliberately not accepted as a filter — it's user-editable and not guaranteed unique within a project.

status
string | null
trigger
string | null

Optional trigger filter. Accepts:

  • latest — return every row sharing the most recent trigger for this env; falls back to the latest row per component when the env has no trigger history.
  • a UUID — return every row produced by that trigger.

Response

Deployments listed successfully

deployments
object[]
required