Skip to main content

Create Program

POST /programs

Request Parameters

Header Parameters

NameTypeDescription
program-idstring

Request Body

NewProgram | application/json

NameTypeProperties
program_idstring
program_name requiredstring
high_engagement_thresholdinteger

description: This value is the number of actions establishing a user as 'highly engaged' (your best customers) for the purposes of inclusion in the engagement model.

event_relevance_decayinteger

description: This value is the number of days for events to lose half their weight (also called event half-life), implemented as a decay curve over time. This value is used to account for recency relevance so newer actions can carry extra weight in calculations.

        <br/>
action_weight_floornumber

description: This value is the minimum user action recommendation weight required for the action to be included in the final recommendations. Higher numbers bring higher confidence in the recommendations but also limit the number of recommendations provided.

descriptionstring

Request Example

{
"program_id": "string",
"program_name": "string",
"high_engagement_threshold": "integer",
"event_relevance_decay": "integer",
"action_weight_floor": "number",
"description": "string"
}

Responses

200 Successful Response

NewProgramResponse | application/json

NameTypeProperties
api_key requiredstring
program_id requiredstring

Response Example

{
"api_key": "string",
"program_id": "string"
}

422 Validation Error

HTTPValidationError | application/json

NameTypeProperties
detailarray

items: {'$ref': '#/components/schemas/ValidationError'}

ValidationError | application/json

NameTypeProperties
loc requiredarray

items: {'anyOf': [{'type': 'string'}, {'type': 'integer'}]}

msg requiredstring
type requiredstring