List invocations

GET

/api/v1/projects/{id}/functions/{functionId}/invocations

curl --request GET \
  --url 'https://api.deploybase.eu/api/v1/api/v1/projects/example/functions/example/invocations?page=1&page_size=20&trigger=queued' \
  --header 'Authorization: <Authorization>'

Returns invocations for a function with pagination, newest first. Each row carries trigger (queued, schedule or schedule_manual; absent on rows from before DEP-247) and, for scheduled runs, scheduled_for. The trigger filter: queued also matches rows without a trigger; schedule matches both cron and “run now” runs; schedule_manual matches “run now” runs only. Requires the member role or above.

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Project ID

functionId

required

string

Function ID

Query Parameters

page

integer

default: 1

Page number

page_size

integer

default: 20

Page size

trigger

string

Allowed values: queued schedule schedule_manual

Only invocations from this door

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

invocations

Array<object>

object

created_at

string

error_message

string

expires_at

string

finished_at

string

function_id

string

id

string

log_output

string

request_headers

object

key

additional properties

any

request_method

string

request_url

RequestURL is the absolute URL the handler is given as request.url (DEP-398): https://{function}-{subdomain}.{FN_BASE_DOMAIN}/?{raw query}, the same origin and pathname the HTTP door serves the same file on. It is built in the handler layer, which is the only layer that knows the project’s subdomain. TEXT, not varchar: a query string has no useful ceiling. Rows written before DEP-398 hold the API’s own route path instead.

string

response_headers

object

key

additional properties

any

response_status

integer

scheduled_for

ScheduledFor is the nominal cron slot of a scheduled run (DEP-247).

string

started_at

string

status

string

Allowed values: pending running completed failed cancelled timed_out

team_id

string

timeout_seconds

integer

trigger

Trigger is the door that created the invocation; nil on pre-DEP-247 rows.

string

Allowed values: queued schedule schedule_manual

updated_at

string

worker_id

string

page

integer

page_size

integer

total

integer

Example

{
  "data": {
    "invocations": [
      {
        "status": "pending",
        "trigger": "queued"
      }
    ]
  }
}

400

Bad Request

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

Forbidden

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

404

Not Found

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

500

Internal Server Error

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}