> ## Documentation Index
> Fetch the complete documentation index at: https://docs.manalens.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Update Properties

> Set or delete properties for up to 100 user profiles in one request. Each item is a flat object with a required user_id. null deletes a property. Each item gets its own result, so one bad item does not fail the batch.

```http theme={null}
PUT /v0/projects/{projectId}/profiles/properties
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

Use this endpoint for a backfill or a sync, for example to link many players to their Discord accounts at once. Authentication and the property rules are the same as for [Update Properties](https://docs.manalens.dev/api/profiles/update-properties.md).

## Body

An array of 1 to 100 items. Each item is a flat object: `user_id` plus the properties for that profile. The body is at most 200 KB.

```json theme={null}
[
  { "user_id": "player_42", "discord_id": "112233445566778899" },
  { "user_id": "player_43", "steam_id": "76561197960287930", "twitter": null }
]
```

| Rule | Value |
| - | - |
| `user_id` | Required in each item. 1 to 255 characters. |
| Properties | 1 to 50 per item. The same key and value rules as the single endpoint. |
| Same `user_id` twice | The second item fails. Merge its properties into the first item. |

## Response

`200` when at least one item is valid. `results` has one entry per item, in request order:

```json theme={null}
{
  "updated": 1,
  "failed": 1,
  "updated_at": "2026-11-15T12:00:00.000Z",
  "results": [
    { "index": 0, "user_id": "player_42", "set": ["discord_id"], "deleted": [] },
    { "index": 1, "user_id": "player_43", "error": { "code": "INVALID_PROPERTIES", "message": "steam_id must be a SteamID64 (17 digits that start with 7656119)" } }
  ]
}
```

Valid items are written; failed items are not. When no item is valid, the response is `400` with `INVALID_PROPERTIES` and the same `results`. The batch response does not return the merged properties; read a profile with MCP `get_profile` or open its **Properties** tab.

## Delete properties in a batch

Send `null`. Set and delete can mix in one item and across items:

```bash theme={null}
curl -sS -X PUT \
  -H "Authorization: Bearer $UA_PROJECT_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    { "user_id": "player_42", "discord_id": null, "discord": null },
    { "user_id": "player_43", "discord_id": "998877665544332211" }
  ]' \
  "https://YOUR_API_ENDPOINT/v0/projects/$PROJECT_ID/profiles/properties"
```

## Errors

The request-level errors are the same as for [Update Properties](https://docs.manalens.dev/api/profiles/update-properties.md#errors). The body limit is 200 KB. A request-level `400` (not an array, or more than 100 items) writes nothing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.