Skip to content

List functions

View .md
GET

The project's functions, newest first.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Query parameters

  • limitinteger
    Default50
    Limitsmin 1 · max 100
  • cursorstring

Responses

200A page of functions.
  • itemsobject[]required
    16 properties
    • idstringrequired
    • slugstringrequired
    • namestringrequired
    • descriptionstringnullable
    • runtimestringrequired
    • statusstringrequired
      One ofdraftdeployingactivefaileddisabled
    • enabledbooleanrequired

      True only while a version is live and not paused (status: active). A draft, a failed first deploy, a deploy in progress or a pause are all false.

    • timeoutSecintegerrequired
    • memoryMbintegerrequired
      One of1282565121024
    • architecturestringrequired

      arm64 is the default and the cheaper one; x86_64 bills each invocation at 1.25x units. Applied on the next deploy.

      One ofarm64x86_64
    • httpEnabledbooleanrequired
    • publicUrlstring<uri>nullable

      Null while httpEnabled is false: the URL does not serve then.

    • activeDeploymentIdstringnullable
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
    • pausedbooleanrequired

      The customer paused it. A deploy, a git push or a rollback does not resume it. Pausing stops event triggers; the HTTP endpoint has its own switch, httpEnabled, and the tools of the agents it declares keep answering.

  • nextCursorstringrequirednullable
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject

    Machine-readable context. Keys that mean the same thing everywhere: - errors: present on every 400 invalid_request for an invalid body or query parameter, [{path, message, ...}], path naming the field (["to"], ["contacts", 2, "recipient"], ["limit"]). - recommendation: one sentence saying what to do next. - dashboardUrl: the dashboard screen that fixes it. - connect: on 409 no_channel, the channels this project can connect to reach the recipient, each {type, request, note, available, dashboardUrl?}; request is the exact call (POST /v2/channels with its body, or POST /v2/numbers), or null for a channel connected from the dashboard (WhatsApp, Instagram, Messenger). available: false says why in note (one-way SMS closed until business verification is approved). - address / from: the address the error is about, under the name the request used for it.

    1 properties
    • errorsobject[]
      3 properties
      • pathobject[]required
      • messagestringrequired
      • codestring