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

# Update Space

`PATCH /v2/spaces/{space_id}`

## Path parameters

- `space_id` string, required

## Request body

- union
  - UpdateAccountRequest
    - `name` string, nullable
    - `parent_id` string, nullable
    - `external_ids` object, nullable
    - `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
    - `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

---

[API](https://skmtc.dev/getauctor/apis/fastapi.md) · [All operations](https://skmtc.dev/getauctor/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getauctor/fastapi/revisions/aeb6faa3b8f0/schema)