Functions

Invoke a function (POST)

Invokes a deployed function. Free functions return the direct function response. Paid functions require Idempotency-Key for retry-safe billing. A new paid call creates one idempotency record and one durable run, returns the retained result when it finishes within the bounded wait, or returns 202 with run_id/operation_id and next_actions[] for polling. Reusing the same key with the same canonical JSON intent replays the terminal result/error; reusing it with a different intent returns 409 idempotency_conflict. Insufficient allowance and other pre-dispatch failures do not consume the key.

post/functions/v1/{name}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/functions/v1/{name}
  • Auth: API key in header apikey

Path parameters

namestring required

Headers

Idempotency-Keystring

Required for paid functions. Stable caller-generated key for one paid intent; reuse it for retries of the same canonical JSON request.

Request body

object required

Response

Function response. Schema and content type are controlled by the deployed function.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.