SolutionsPricingDocsStart Free
Api

Publish Referee Offer

POST
/v1/programs/{programId}/referee-offer/versions

Publish a new referee offer version: what a referred person gets, as shown in the Widget and join page. A write applies at once. Needs the programs:write key permission.

Authorization

WorkspaceApiKey
X-Api-Key<token>

Workspace-owned Better Auth API key of one environment (Sandbox or Live); it authorizes the Projects of that environment in its Workspace. A Project of the other environment returns 403 ENVIRONMENT_MISMATCH. Never expose it in the browser.

In: header

Path Parameters

programId*string
Match\S
Length1 <= length <= 512

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/programs/string/referee-offer/versions" \  -H "Content-Type: application/json" \  -d '{    "terms": {      "calculation": "percentage",      "currency": "string",      "currencyExponent": 0,      "validityDays": 1,      "changeNote": "string"    },    "projectId": "string"  }'
{  "success": true,  "data": {    "offerVersionId": "string",    "version": 1,    "publishedAt": "string",    "effectiveAt": "string"  }}