Create a programme
/v1/programsRequires an API client bearer token.
Creates a card programme and snapshots its module configuration. Requires an Idempotency-Key header. Emits programme.created with the full module snapshot.
Parameters
Header parameters
| Name | Required | Description |
|---|---|---|
| Idempotency-Key | required | Client-chosen. An identical retry with the same key returns the stored response; reusing the key with a different payload returns 409. |
Request body
The region the programme is homed to, fixed at creation. Optional: omitted, the programme is homed to the platform's only region.
Non-toggleable keys are accepted but persisted false
+ show properties− hide properties
true = M2 (we decide); false = M2b delegated
Per-mode platform settlement account a refund credit is drawn from. Absent ⇒ refunds decline.
+ show properties− hide properties
Example
curl -X POST https://api.rigid.fi/v1/programs \
-H "Authorization: Bearer $RIGID_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"name": "string"
}'Responses
201Created programme.
+ show properties− hide properties
Per-mode platform settlement account a refund credit is drawn from. Absent ⇒ refunds decline.
+ show properties− hide properties
+ show properties− hide properties
Allowed WebAuthn origins, each the BARE origin a browser sends in its Origin header — scheme://host with a port only when it is not the default, and no path, trailing slash, query, fragment or userinfo. Each origin's host must be passkey_rp_id or a subdomain of it, or the browser refuses the ceremony. `http` is accepted only for localhost.
400Validation error
401Authentication required
403Forbidden
409Idempotency-Key reused with a different payload
500Internal server error