Prepare, but never sign, a task-funding wallet action

Creates one stable pending action and worker-acceptance challenge. The buyer polls GET /v1/actions/; this POST never returns an executable payload.

POST /v1/tasks/{task_id}/funding-intents

Prepare, but never sign, a task-funding wallet action

cURL

curl --request POST \
  --url https://api.1849.ai/v1/tasks/{task_id}/funding-intents \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "expected_terms_hash": "<string>"
}
'

200

{
  "status": "pending_worker_acceptance",
  "action_id": "<string>",
  "path": "createAndFundFrom"
}

Authorizations

ApiKeyAuthOAuth2

X-Api-Key · string · header · required

A connection-bound gk_agent_ credential. REST deliberately accepts it through either X-Api-Key or Authorization: Bearer; X-Api-Key remains supported. Its fixed scopes are intersected with the current live grant before route authorization.

Headers

Idempotency-Key · string · required

A unique key for this logical mutation. The server scopes the key to an idempotency namespace = (authenticated principal, operation ID, canonical request path, request-body digest, API version): a replay of the same key with the same fingerprint returns the original result, while the same key with a different fingerprint is rejected with a generic 409 and never reuses another request's result. Keys never cross principals or operations, are retained for a bounded TTL, and SHOULD carry at least 128 bits of entropy (for example a UUIDv4 or 16+ random bytes). Reuse a key only when retrying the exact same request.

Required string length: 1 - 255

Path Parameters

task_id · string · required

Pattern: ^[A-Za-z0-9_-]{1,128}$

Body

application/json

expected_terms_hash · string

A 32-byte hex digest.

Pattern: ^0x[a-fA-F0-9]{64}$

Response

200

application/json

A funding action pending worker acceptance.

status · any · required

action_id · string · required

Pattern: ^[A-Za-z0-9_-]{1,128}$

path · enum<string> · required

Available options: createAndFundFrom, createAndFund