Durable Functions

List durable approvals

Changed on

Lists the approvals durable workflows in the project have requested, newest first. Pending approvals are the ones a workflow is waiting on; decided, expired, and cancelled ones are kept for a year.

Project access tokens can list approvals, including read-only ones.

get/projects/{id}/durable-approvals

Request

  • Base URL: https://api.volcano.dev
  • URL: https://api.volcano.dev/projects/{id}/durable-approvals
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring uuid required

Project ID

Query parameters

pageinteger

Page number (1-indexed) for offset pagination. Declares no schema default so the request validator does not inject one: handlers that omit page see it unset (nil) and default to 1 in code, while cursor-first endpoints (e.g. the project deployments feed) can detect its absence to stay in keyset/search mode. Supplying page selects offset pagination.

limitinteger

Number of items per page (max 100)

status'pending' | 'approved' | 'denied' | 'expired' | 'cancelled'

pending means the workflow is waiting for a decision. approved and denied are decisions a person made. expired means the workflow's approval timeout passed first, and cancelled means the execution ended while the approval was still pending. Every status but pending is final.

Return only approvals in this status.

functionstring

Only approvals requested by this durable function, given by id or by name. A name also matches approvals from a deleted function of that name.

execution_idstring uuid

Return only approvals requested by this durable execution.

fromstring date-time

Return only approvals requested at or after this time.

tostring date-time

Return only approvals requested before this time.

Response

Successful response

pageinteger required

Current page number (1-indexed)

limitinteger required

Number of items per page

totalinteger required

Total number of items across all pages

has_moreboolean required

Whether there are more pages available

Changes