PUT/api/v2/referrals/programs/{programId}/level-assignments/{userId}

Assigns (or revokes) a program level directly to a user, e.g. a hidden influencer rate.

Authentication

Send your API key in the x-api-key header on every request.

Parameters

Request parameters
FieldTypeRequiredDescription
programId (path)string (uuid)Yes
userId (path)integer (int32)Yes

Request body

application/json

Request body fields
FieldTypeRequiredDescription
LevelIdstring (uuid)Yes
ExpiresAtstring (date-time)No
NotesstringNo
ActivebooleanNoFalse revokes the assignment; the user falls back to the metric-based level.

Responses

200 — OK

Response 200 fields
FieldTypeRequiredDescription
UserIdunknownYes
NamestringYes
EmailstringYes
LevelIdstring (uuid)Yes
LevelCodestringYes
LevelNamestringYes
AssignedAtstring (date-time)Yes
ExpiresAtstring (date-time)Yes
RevokedAtstring (date-time)Yes
NotesstringYes

Example request

curl -X PUT "https://{base_url}/api/v2/referrals/programs/{programId}/level-assignments/{userId}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"LevelId":"…"}'

This page is generated from the live OpenAPI specification and always matches the current API.