Update a profile | Documentation

curl -L \
  -X POST \
  -H 'Content-Type: application/json' \
  'https://experience.ninetailed.co/v2/organizations/{organizationId}/environments/{environmentSlug}/profiles/{profileId}' \
  -d '{"events":[{"channel":"web","context":{"app":{"name":"Ninetailed Analytics SDK","version":"1.0.0"},"library":{"name":"Ninetailed Analytics SDK","version":"1.0.0"},"userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36","campaign":{},"locale":"en-US","page":{"path":"/","query":{},"referrer":"","search":"","url":"https://example.com/"}},"messageId":"58f358f2-a858-11ed-afa1-0242ac120002","timestamp":"2022-10-10T14:36:51.262Z","type":"identify","traits":{"favAnimal":"fox"},"userId":"asdf"}]}'

{
  "data": {
    "profile": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "stableId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "random": 0.42,
      "audiences": [
        "audience-1"
      ],
      "traits": {
        "favAnimal": "fox"
      },
      "location": {},
      "session": {}
    },
    "experiences": [
      {
        "experienceId": "exp-1",
        "variantIndex": 1,
        "variants": {
          "entryA": "entryB"
        }
      }
    ],
    "changes": [
      {
        "key": "heroTitle",
        "type": "Variable",
        "value": "Welcome back!",
        "meta": {
          "experienceId": "exp-2",
          "variantIndex": 1
        }
      }
    ]
  },
  "error": null,
  "message": "ok"
}

Updates an existing profile and returns it with updated variant selections. The organizationId is the Client ID from Settings → SDK Keys → Optimization.

Path parameters

environmentSlugstringRequiredDefaults to main

The slug of the environment of the profile to retrieve

organizationIdstringRequired

The ID of the organization of the profile to retrieve

profileIdstringRequired

The ID of the profile to retrieve

Query parameters

localestringOptionalDefaults to en

An ISO 639-1 language code used for experience evaluation.

typeenumOptional

Set to preflight to evaluate experiences without persisting state. Useful for SSR/ESR.

Allowed values:

Request

This endpoint expects an object.

Response

Successful response

Errors

400

Bad Request Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error