# List spaces

Retrieve all project spaces/folders in the workspace

Endpoint: GET /spaces
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `archived` (boolean)
    Include archived spaces

  - `search` (string)
    Search spaces by name (case-insensitive)
    Example: "Nike"

  - `expands` (array)
    Expand related data in the response
    Enum: "projects"

## Response 200 fields (application/json):

  - `spaces` (array)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 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 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"