Update Workspace

post /v1/organizations/workspaces/{workspace_id}

Update Workspace

Path Parameters

• workspace_id: string

Body Parameters

• data_residency: optional object { allowed_inference_geos, default_inference_geo }

  Data residency configuration for the workspace.

  • allowed_inference_geos: optional array of string or "unrestricted"

    Permitted inference geo values. Use 'unrestricted' to allow all geos, or a list of specific geos.

    • array of string

    • "unrestricted"

      • "unrestricted"

  • default_inference_geo: optional string

    Default inference geo applied when requests omit the parameter. Must be a member of allowed_inference_geos unless allowed_inference_geos is "unrestricted".

• name: optional string

  Name of the Workspace.

• tags: optional map[string]

  User-defined tags as string key-value pairs. Keys may not begin with anthropic.

Returns

• Workspace object { id, archived_at, created_at, 5 more }

  • id: string

    ID of the Workspace.

  • archived_at: string

    RFC 3339 datetime string indicating when the Workspace was archived, or null if the Workspace is not archived.

  • created_at: string

    RFC 3339 datetime string indicating when the Workspace was created.

  • data_residency: object { allowed_inference_geos, default_inference_geo, workspace_geo }

    Data residency configuration.

    • allowed_inference_geos: array of string or "unrestricted"

      Permitted inference geo values. 'unrestricted' means all geos are allowed.

      • array of string

      • "unrestricted"

        • "unrestricted"

    • default_inference_geo: string

      Default inference geo applied when requests omit the parameter.

    • workspace_geo: string

      Geographic region for workspace data storage. Immutable after creation.

  • display_color: string

    Hex color code representing the Workspace in the Anthropic Console.

  • name: string

    Name of the Workspace.

  • tags: map[string]

    User-defined tags as string key-value pairs. Keys may not begin with anthropic.

  • type: "workspace"

    Object type.

    For Workspaces, this is always "workspace".

    • "workspace"

Example

curl https://api.anthropic.com/v1/organizations/workspaces/$WORKSPACE_ID \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY" \
    -d '{
          "tags": {
            "env": "prod",
            "team": "platform"
          }
        }'

Response

{
  "id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
  "archived_at": "2024-11-01T23:59:27.427722Z",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "data_residency": {
    "allowed_inference_geos": "unrestricted",
    "default_inference_geo": "default_inference_geo",
    "workspace_geo": "workspace_geo"
  },
  "display_color": "#6C5BB9",
  "name": "Workspace Name",
  "tags": {
    "env": "prod",
    "team": "platform"
  },
  "type": "workspace"
}