NYnylas
Workspaces

Update a workspace

Changed on

Updates the specified workspace. You can't add, change, or remove a workspace's domain after you create the workspace. You can set auto_group to true only on a workspace that has a domain.

On the application's default workspace, you can update only the policy_id and rule_ids values.

patch/v3/workspaces/{workspace_id}

Request

  • Base URL
    https://api.us.nylas.com
  • Auth
    HTTP bearer

Request body

auto_groupboolean

When true, specifies that newly created grants in the application are automatically assigned to the workspace if their email address' domain matches the domain. Nylas returns a 400 error if you set this to true on a workspace without a domain.

namestring

A short, descriptive name for the workspace.

policy_idstring nullable

The ID of the policy to attach to the workspace. Set a policy ID to attach the policy, set null to detach the current policy, or omit the field to keep the current value. The policy must belong to your application.

rule_idsstring[] nullable

The IDs of any rules to attach to the workspace. Set an array to replace the current rules, set null or an empty array to detach all rules, or omit the field to keep the current value. Each rule must belong to your application.

Example request

{
  "auto_group": true,
  "name": "The Nylas Workspace",
  "policy_id": "6dcc5d92-8a55-4ce8-85a8-2f4275f8f0a0",
  "rule_ids": [
    "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
  ]
}

Response

Success. Returns updated Workspace object.

request_idstring

The request ID.

Example response

{
  "request_id": "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90",
  "data": {
    "application_id": "ad410018-d306-43f9-8361-fa5d7b2172e0",
    "auto_group": true,
    "created_at": 1756379932,
    "domain": "nylas.com",
    "name": "The Nylas Workspace",
    "policy_id": "6dcc5d92-8a55-4ce8-85a8-2f4275f8f0a0",
    "rule_ids": [
      "3f2504e0-4f89-41d3-9a0c-0305e82c3301"
    ],
    "updated_at": 1756379932,
    "workspace_id": "abf6ff99-05ad-4c0a-aaf8-400aacf2470a"
  }
}

Changes