---
title: "Update workspace assignments"
method: POST
path: "/v3/workspaces/{workspace_id}/manual-assign"
tags: ["Workspaces"]
---

# Update workspace assignments

`POST /v3/workspaces/{workspace_id}/manual-assign`

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.

## Request body

- object
  - `assign_grants` string[] — A list of grant IDs to be assigned to the workspace.
  - `remove_grants` string[] — A list of grant IDs to be removed from the workspace.

## Response `200`

Success. Returns updated grant information.

- object
  - `request_id` string — The request ID.
  - `data` object
    - `application_id` string — The ID of the Nylas application associated with the workspace.
    - `domain` string — The top-level domain associated with the workspace.
    - `grants_assigned` string[] — A list of grant IDs assigned to the workspace.
    - `grants_removed` string[] — A list of grant IDs removed from the workspace.
    - `workspace_id` string — The ID of the workspace that was updated.

## Other responses

- `401` — Error: Not authenticated
- `404` — Error: Not found

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)