# Update space

Update an existing space

Endpoint: PUT /spaces/{spaceId}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `spaceId` (string, required)
    Space identifier (alias or ID)
    Example: "commercial-productions"

## Request fields (application/json):

  - `name` (string)
    Updated space name
    Example: "Documentary Unit"

  - `image` (string,null)
    Updated space image URL
    Example: "https://cdn.production.com/doc-banner.jpg"

  - `archived` (boolean)
    Updated archived status
    Example: true

## Response 200 fields (application/json):

  - `id` (string, required)
    Space identifier (alias in user mode, UUID in system mode)
    Example: "commercial-productions"

  - `alias` (string, required)
    URL-friendly space identifier
    Example: "commercial-productions"

  - `name` (string, required)
    Space display name
    Example: "Film Productions"

  - `image` (string,null)
    Space image/banner URL
    Example: "https://cdn.production.com/space-banner.jpg"

  - `archived` (boolean, required)
    Whether the space is archived

  - `projectCount` (integer)
    Number of projects in this space
    Example: 12

  - `projects` (array)
    Projects in this space (when expanded)

  - `projects.id` (string, required)
    Project identifier (alias in user mode, UUID in system mode)
    Example: "nike-swoosh-commercial"

  - `projects.name` (string,null)
    Project display name
    Example: "Nike Swoosh Commercial"

  - `projects.icon` (string,null)
    Project icon or emoji
    Example: "☀️"

  - `projects.imageUrl` (string,null)
    Project image URL
    Example: "https://example.com/project-banner.jpg"

  - `projects.spaceId` (string,null)
    Associated project space ID (deprecated, use space object)
    Example: "commercial-productions"

  - `projects.space` (object,null)
    Project space/folder information

  - `projects.space.id` (string)
    Space identifier
    Example: "commercial-productions"

  - `projects.templateId` (string,null)
    Template project ID (deprecated, use template object)
    Example: "commercial-template"

  - `projects.template` (object,null)
    Template project information

  - `projects.template.id` (string)
    Template identifier
    Example: "commercial-template"

  - `projects.template.name` (string)
    Template name
    Example: "Commercial Template"

  - `projects.status` (string, required)
    Project status
    Enum: "active", "archived"

  - `projects.labels` (array)
    Project labels for categorization
    Example: ["nike","q2-2024","post-production"]

  - `projects.createdAt` (string, required)
    Project creation timestamp
    Example: "2024-01-15T10:00:00Z"

  - `projects.updatedAt` (string, required)
    Project last update timestamp
    Example: "2024-03-20T14:30:00Z"

  - `createdAt` (string)
    Space creation timestamp
    Example: "2024-01-05T09:00:00Z"

  - `updatedAt` (string)
    Space last update timestamp
    Example: "2024-03-15T12:00:00Z"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 404 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"