Sign in
Workspaces

Update workspace assignments

Manually assigns or removes specified grants to or from a specific workspace. You must specify at least one grant ID in either assign_grants or remove_grants. You can include up to 500 grants per list.

post/v3/workspaces/{workspace_id}/manual-assign

Request body

assign_grantsstring[]

A list of grant IDs to be assigned to the workspace.

remove_grantsstring[]

A list of grant IDs to be removed from the workspace.

Example request

{
  "assign_grants": [
    "123e4567-e89b-12d3-a456-426614174001"
  ],
  "remove_grants": [
    "123e4567-e89b-12d3-a456-426614174001"
  ]
}

Response

Success. Returns updated grant information.

request_idstring

The request ID.

Example response

{
  "request_id": "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90",
  "data": {
    "application_id": "123e4567-e89b-12d3-a456-426614174000",
    "domain": "nylas.com",
    "grants_assigned": [
      "123e4567-e89b-12d3-a456-426614174001",
      "123e4567-e89b-12d3-a456-426614174003"
    ],
    "grants_removed": [
      "123e4567-e89b-12d3-a456-426614174002"
    ],
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.