# List projects

Retrieve projects for the current workspace. Supports filtering by ID, space, status, name, space name, or labels.

Endpoint: GET /projects
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `id` (any)
    Return only projects matching these IDs or aliases
    Example: ["nike-swoosh-commercial"]

  - `spaceId` (any)
    Return projects belonging to these space IDs or aliases
    Example: ["commercial-productions"]

  - `status` (string)
    Filter by project status
    Enum: "active", "archived"

  - `name` (any)
    Case-insensitive substring match on project name
    Example: ["Swoosh"]

  - `spaceName` (any)
    Case-insensitive substring match on space name
    Example: ["Commercial"]

  - `labels` (any)
    Return projects that include all specified labels
    Example: ["nike","q2-2024"]

## Response 200 fields (application/json):

  - `projects` (array)

  - `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.space.name` (string)
    Space display name
    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"

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