Skip to content
Thyme Docs

Functions

Upload function release

POST/api/task/upload

Upload the ZIP produced by the Thyme CLI. Metadata is JSON encoded in the data field. The checksum is SHA-256 of the complete ZIP, including permissions.json when present. Active name/tag/checksum matches return the existing release; this endpoint does not implement Idempotency-Key replay. Owner/admin membership and functions:upload are required. Required scope: functions:upload. Owner/admin membership is required.

Request Body

multipart/form-data
dataRequired
string

JSON-encoded metadata: workspaceId, projectId, taskName, checkSum (SHA-256), optional versionTag, optional schema (JSON string), optional definedCallbacks (string array). permissions.json must be inside the archive, not this metadata.

Example{"workspaceId":"WORKSPACE_ID","projectId":"PROJECT_ID","taskName":"price-watcher","versionTag":"v1","checkSum":"SHA256_OF_ZIP"}
blobRequired
string <binary>

Responses

List function releases

GET/api/v1/functions

Required scope: functions:read.

Query Parameters

projectIdRequired
string
name
string

Filter one function family and include version reservations.

limit
integer·min 1·max 200·default 50
cursor
string

Header Parameters

X-Workspace-Id
string

Required for an unbound key; a management credential is already workspace-bound.

Responses

Get function release

GET/api/v1/functions/{functionId}

Required scope: functions:read.

Path Parameters

functionIdRequired
string

Header Parameters

X-Workspace-Id
string

Required for an unbound key; a management credential is already workspace-bound.

Responses

Delete function release

DELETE/api/v1/functions/{functionId}

Required scope: functions:delete. Owner/admin membership is required.

Path Parameters

functionIdRequired
string

Header Parameters

X-Workspace-Id
string

Required for an unbound key; a management credential is already workspace-bound.

Idempotency-Key
string·min 1·max 128

Opaque 1–128 character key retained for 24 hours. Use a different key for every target resource and intended mutation: some fingerprints use the route template without the resource ID.

Responses

Copy function release

POST/api/v1/functions/{functionId}/copy

Required scope: functions:upload. Owner/admin membership is required.

Path Parameters

functionIdRequired
string

Header Parameters

X-Workspace-Id
string

Required for an unbound key; a management credential is already workspace-bound.

Idempotency-Key
string·min 1·max 128

Opaque 1–128 character key retained for 24 hours. Use a different key for every target resource and intended mutation: some fingerprints use the route template without the resource ID.

Request Body

application/json
targetProjectIdRequired
string
name
string
versionTag
string·min 1·max 32

Responses

Get function source

GET/api/v1/functions/{functionId}/source

Required scope: functions:source.

Path Parameters

functionIdRequired
string

Header Parameters

X-Workspace-Id
string

Required for an unbound key; a management credential is already workspace-bound.

Responses