POST
/
v1
/
public
/
flowStates
curl --request POST \
  --url https://api.frigade.com/v1/public/flowStates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "userId": "d34daa11-3745-4ac0-880e-d4b4d51fe13f",
  "groupId": "x34daa11-3745-4ac0-880e-d4b4d51fe13f",
  "flowSlug": "flow_abc",
  "stepId": "<string>",
  "data": {
    "action": "click"
  },
  "actionType": "COMPLETED_STEP"
}'
{
  "eligibleFlows": [
    {
      "flowSlug": "flow_abc",
      "flowName": "Onboarding Checklist",
      "flowType": "ANNOUNCEMENT",
      "data": {
        "steps": [
          {
            "id": "step_abc",
            "$state": {
              "completed": true,
              "started": true,
              "visible": true,
              "blocked": true,
              "lastActionAt": "2024-09-01T00:00:00.000Z"
            }
          }
        ]
      },
      "$state": {
        "currentStepId": "step_abc",
        "currentStepIndex": 1,
        "completed": true,
        "started": true,
        "skipped": true,
        "visible": true,
        "lastActionAt": "2024-09-01T00:00:00.000Z"
      }
    }
  ],
  "ineligibleFlows": [
    "<string>"
  ]
}

Authorizations

Authorization
string
headerrequired

Authentication header of the form Bearer: <token>, where <token> is your public or private Frigade API key

Body

application/json
userId
string
required

The ID of the user

groupId
string

Optional ID of the group

flowSlug
string
required

The Flow Slug

stepId
string

The Step ID if updating a specific Step

data
string

Any optional data including the user action

actionType
enum<string>
required

The type of action the user took

Available options:
STARTED_STEP,
COMPLETED_STEP,
NOT_STARTED_STEP,
STARTED_FLOW,
COMPLETED_FLOW,
SKIPPED_FLOW,
NOT_STARTED_FLOW

Response

201 - application/json
eligibleFlows
object[]

List of Flows that the user is eligible for as well as the user's state in each Flow

ineligibleFlows
string[]

List of Flow IDs that the user is ineligible for (for instance if a Flow is turned off)