Applications

Set application assignees

PUT
/api/applications/{id}/assignees

Replaces the assignee list on an Application. Assignment, not ownership: several users may be assigned, and [] is a valid unassigned state. Any member of the organization may assign; every assignee must belong to the application's own organization. This is the only write path for assignees - the generic PUT /api/applications/{id} ignores the field. Revisioned: pass the expectedRevision you read, and a commandIdempotencyKey so a retry is not applied twice.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/api/applications/string/assignees" \  -H "Content-Type: application/json" \  -d '{    "assigneeIds": [      "64a1b2c3d4e5f60012345679"    ],    "expectedRevision": 4,    "commandIdempotencyKey": "a7f3c0de-1b2a-4c3d-9e8f-0a1b2c3d4e5f"  }'
{  "success": true,  "message": "Application created successfully",  "data": {    "_id": "64d2f9c5e8a1d4e001a0b1c2",    "name": "Maple Court - Unit 412",    "organizationId": "64a1b2c3d4e5f60012345678",    "status": "in_progress",    "pipelineStage": "Tour scheduled",    "createdAt": "2026-04-12T14:22:10.000Z",    "updatedAt": "2026-04-12T14:22:10.000Z"  }}