Update Custom Attributes

PUT https://api.botsi.com/v2/custom-attributes

Update existing attribute values, as when a user upgrades from premium to vip, for example.

This route accepts $BOTSI_SECRET_KEY or $BOTSI_PUBLIC_KEY in the Authorization header, with no Bearer prefix. The sample sends the secret key. From inside the app, send the public key. Delete a Profile is the exception and accepts the secret key only. See Authentication.

Identify the user with profileId. Each attribute is targeted by custom[].key.

Request body#

Parameter	Type	Required	Description
`profileId`	string	Required	Botsi profile ID from Create a Profile
`custom`	array	Required	Attribute objects. Must contain at least one
`custom[].key`	string	Required	The attribute key to update
`custom[].value`	string	Required	The new value

# Authorization: $BOTSI_SECRET_KEY or $BOTSI_PUBLIC_KEY
curl -X PUT "https://api.botsi.com/v2/custom-attributes" \
  -H "Authorization: $BOTSI_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "0072102a-c00c-4ea5-9271-1b6e975f2d63",
    "custom": [
      { "key": "user_level", "value": "vip" },
      { "key": "subscription_type", "value": "annual" }
    ]
  }'

PUT only updates attributes that already exist

The update is atomic. If any key in custom is missing from the Profile, nothing is written and the 404 names the keys it could not find.

Create attributes with Add Custom Attributes first. Multi-select keys use the same <question>.<option> format described under Multi-select answers, and a key not yet saved returns 404, so first-time answers go through POST.

Errors#

Code	Message	Cause
`400`	`custom must contain at least 1 elements`	The `custom` array was empty
`404`	`Custom attribute key(s) not found on profile 0072102a-c00c-4ea5-9271-1b6e975f2d63: user_level. PUT only updates existing attributes — create them with POST /v2/custom-attributes.`	At least one key does not exist on the Profile. Nothing was written

Response#

{
  "ok": true,
  "data": [
    { "id": "abc123", "key": "user_level", "value": "vip" },
    { "id": "def456", "key": "subscription_type", "value": "annual" }
  ]
}