Creates a new chat with the specified users.
| Permission | Description |
|---|---|
chats.create | Start a new chat |
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| users | array | Yes | Array of user IDs | [1, 2, 3] |
{
"users": [1, 2, 3]
}
Returns the created chat resource.
{
"chat": { /* chat resource */ }
}
For a full schema, see Chat Resource.
| Status | Description | Reference |
|---|---|---|
| 422 | Validation error | Validation error |
| 401 | Unauthorized | Authentication error |
| 403 | Forbidden (no permission) | Permission error |