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

# Register a space

> Register a space by providing the path to a directory containing a `workspace.yml` file.



## OpenAPI

````yaml /api-reference/openapi.json post /api/workspaces/add
openapi: 3.1.0
info:
  title: Friday Platform API
  description: >-
    The Friday daemon HTTP API for managing spaces, agents, sessions, and
    automations.
  version: 1.0.0
servers:
  - url: http://localhost:18080
    description: Local Friday daemon
security: []
tags:
  - name: Health
    description: Daemon health and status
  - name: Spaces
    description: Space management
  - name: Chat
    description: Conversational AI
  - name: Sessions
    description: Execution session management
  - name: Signals
    description: Trigger management
  - name: Agents
    description: Agent discovery and inspection
  - name: Artifacts
    description: File and data artifact management
  - name: Configuration
    description: Daemon configuration
paths:
  /api/workspaces/add:
    post:
      tags:
        - Spaces
      summary: Register a space
      description: >-
        Register a space by providing the path to a directory containing a
        `workspace.yml` file.
      operationId: addWorkspace
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - path
              properties:
                path:
                  type: string
                  description: >-
                    Absolute path to the space directory containing
                    workspace.yml
                  example: /data/spaces/my-space
                name:
                  type: string
                  description: Optional display name override
                description:
                  type: string
                  description: Optional description override
      responses:
        '200':
          description: Space registered
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: abc123
                  name:
                    type: string
                    example: my-space
                  status:
                    type: string
                    example: active
                  path:
                    type: string
                  createdAt:
                    type: string
                    format: date-time
                  created:
                    type: boolean
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X POST http://localhost:18080/api/workspaces/add \
              -H 'Content-Type: application/json' \
              -d '{"path": "/path/to/my-space"}'

````