Replace the assignees of a record.

Replace the assignees of a record.

assignees is the full list of user slugs: it replaces the current list, and [] removes everyone. The owner stays the owner when still in the list; otherwise the first slug becomes the owner. Users newly added are notified. The response lists the assignees owner first, with capabilities saying what the credential may now do with the record.

Scope: assign.<object slug>, for example assign.contacts.

Errors:

• 404 — no record has that slug.
• 400 — no active object has that slug.
• 422 — more than 20 assignees (code: TOO_MANY_ASSIGNEES), or an assignee is not a user of this workspace (code: INVALID_ASSIGNEE).

Request:

{
  "assignees": ["a3f1b2c8e9d7", "e6d2b9f41c08"]
}

Response 200:

{
  "status": 200,
  "message": "Assignees updated",
  "data": {
    "assignees": [
      {
        "type": "user",
        "slug": "a3f1b2c8e9d7",
        "name": "Omar Hassan",
        "email": "omar@example.com",
        "profile_image": null
      },
      {
        "type": "user",
        "slug": "e6d2b9f41c08",
        "name": "Lina Farouk",
        "email": "lina@example.com",
        "profile_image": null
      }
    ],
    "capabilities": {
      "can_edit": true,
      "can_delete": true,
      "can_assign": true
    }
  }
}