---
title: "Update Space"
method: PATCH
path: "/v2/spaces/{space_id}"
tags: ["spaces"]
---

# Update Space

`PATCH /v2/spaces/{space_id}`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/v2/spaces/{space_id}`
- Auth: none declared

## Path parameters

- `space_id` string, required

## Request body

- union
  - UpdateAccountRequest
    - `name` string, nullable
    - `parent_id` string, nullable
    - `external_ids` object, nullable: Identifiers for this space in integrated third-party systems, keyed by system. Only these keys are accepted: `azure_devops`, `hubspot`, `jira`, `linear`, `salesforce`, `snow_acct`, `snow_opp`. Any other key is rejected with `400`. To store an identifier from another system (for example a NetSuite customer ID), add a custom field to the template and set it through `PATCH /v2/spaces/{space_id}/custom-fields` instead.
    - `description` string, nullable
    - `website` string, nullable
    - `headquarters` string, nullable
    - `image_url` string, nullable
    - `users` InitialUser[], nullable: A list of users to add to the space. Each user can be specified by user_id or email. Users must already exist and be members of the organization.
      - `user_id` string, nullable: The ID of an existing user in the organization. At least one of user_id or email must be provided.
      - `email` string, nullable: The email of an existing user in the organization. At least one of user_id or email must be provided.
    - `users_remove` InitialUser[], nullable: A list of users to remove from the space. Each user can be specified by user_id or email. All must belong to the same organization as the space.
      - `user_id` string, nullable: The ID of an existing user in the organization. At least one of user_id or email must be provided.
      - `email` string, nullable: The email of an existing user in the organization. At least one of user_id or email must be provided.
  - UpdateProjectRequest
    - `name` string, nullable
    - `parent_id` string, nullable
    - `external_ids` object, nullable: Identifiers for this space in integrated third-party systems, keyed by system. Only these keys are accepted: `azure_devops`, `hubspot`, `jira`, `linear`, `salesforce`, `snow_acct`, `snow_opp`. Any other key is rejected with `400`. To store an identifier from another system (for example a NetSuite customer ID), add a custom field to the template and set it through `PATCH /v2/spaces/{space_id}/custom-fields` instead.
    - `description` string, nullable
    - `start_date` string, date-time, nullable
    - `end_date` string, date-time, nullable
    - `pinned` boolean, nullable
    - `plan_pattern` string, nullable
    - `crm_link` CrmLinkRequest
      - `provider` 'hubspot' | 'salesforce', required
      - `deal_id` string, nullable
      - `deal_url` string, nullable
    - `users` InitialUser[], nullable: A list of users to add to the space. Each user can be specified by user_id or email. Users must already exist and be members of the organization.
      - `user_id` string, nullable: The ID of an existing user in the organization. At least one of user_id or email must be provided.
      - `email` string, nullable: The email of an existing user in the organization. At least one of user_id or email must be provided.
    - `users_remove` InitialUser[], nullable: A list of users to remove from the space. Each user can be specified by user_id or email. All must belong to the same organization as the space.
      - `user_id` string, nullable: The ID of an existing user in the organization. At least one of user_id or email must be provided.
      - `email` string, nullable: The email of an existing user in the organization. At least one of user_id or email must be provided.

## Response `200`

Successful Response

- SpaceResponse
  - `id` string, required
  - `external_ids` object, nullable, required
  - `parent_id` string, nullable, required
  - `type` 'organization' | 'account' | 'project', required: Scope of the space. The v2 spaces API is organization-scoped, so only `organization`, `account`, and `project` spaces are ever returned; personal spaces (`organization_id IS NULL`) are never returned by these endpoints.
  - `name` string, required
  - `created_at` string, required
  - `crm_integration` CrmIntegration
    - `deal` CrmDeal
      - `id` string, required
      - `name` string, required
      - `amount` number, nullable
      - `stage` string, nullable
      - `close_date` string, nullable
      - `currency` string, nullable
      - `external_url` string, nullable
      - `provider` 'hubspot' | 'salesforce', required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-01** `aeb6faa3b8f0`: 1 info
  - removed the `personal` enum value from the `type` response property for the response status `200`

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/v2/spaces/:space_id/patch.md)

---

[API](https://skmtc.dev/getauctor/apis/getauctor-api.md) - [All operations](https://skmtc.dev/getauctor/apis/getauctor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getauctor/apis/getauctor-api/revisions/be39c59c13f6?raw)