> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Space

> Update a space's profile fields

# Update Space

Partial update of a space's profile fields — name, color, icon, contact email,
and social links. Only the fields you supply are written.

Tax and legal-entity details are **not** set here — use
[Set Tax Details](/api-reference/spaces/set-tax-details). Deactivating or
deleting a space remains a dashboard-only operation for now.

Requires the `spaces:write` scope. Tenant-fenced on your organization — an
identifier that doesn't resolve under your org returns `404`.

## Path Parameters

<ParamField path="spaceIdentifier" type="string" required>
  The space's `identifier` (its slug).
</ParamField>

## Request Body

At least one field is required.

<ParamField body="name" type="string">
  New display name (max 200 chars). Must stay unique within the organization
  (case-insensitive).
</ParamField>

<ParamField body="color" type="string">Accent color token.</ParamField>
<ParamField body="icon" type="string">Icon name or emoji.</ParamField>
<ParamField body="icon_type" type="string">`emoji` or `icon`.</ParamField>
<ParamField body="email" type="string">Contact email (shown on receipts).</ParamField>
<ParamField body="linkedin" type="string">Social profile URL.</ParamField>
<ParamField body="instagram" type="string">Social profile URL.</ParamField>
<ParamField body="facebook" type="string">Social profile URL.</ParamField>
<ParamField body="twitter" type="string">Social profile URL.</ParamField>
<ParamField body="website" type="string">Website URL.</ParamField>

<Note>
  The space's `identifier` is immutable via the API — it's referenced by existing
  events and experiences. Create a new space if you need a different identifier.
</Note>

## Response

Returns the updated space — same schema as
[Get Space](/api-reference/spaces/get-space).

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH \
    -H "X-API-KEY: your_api_key" \
    -H "Content-Type: application/json" \
    -d '{ "name": "Milan HQ", "website": "https://milan.acme.com" }' \
    "https://www.gomry.com/api/v1/spaces/milan"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "AbCdEfGhIjKlMnOpQrSt",
      "identifier": "milan",
      "name": "Milan HQ",
      "status": "active",
      "website": "https://milan.acme.com",
      "tax_details": null,
      "created_at": "2025-03-01T10:00:00.000Z",
      "updated_at": "2025-07-15T12:00:00.000Z"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "At least one field is required"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Space not found"
  }
  ```
</ResponseExample>