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

# Export Workspace Config

> Export current workspace configuration as YAML.

This endpoint exports all workspace-scoped resources:
- Agents (excluding system default agent)
- MCP server instances
- Provider configurations

**Important Notes:**
- Secrets (API keys, passwords) are replaced with placeholders
- Built-in/catalog resources (carrying registry_item_id) are excluded
- Only resources in the current workspace are exported
- References to specs are included (server_spec_id, provider_spec_id)

**Returns:**
YAML file content that can be saved and later imported



## OpenAPI

````yaml /api-reference/openapi.json get /v1/workspace/export
openapi: 3.1.0
info:
  description: >-
    Modular and extensible framework for building AI agents. This API requires
    JWT Bearer token authentication for most endpoints. Include your JWT token
    in the Authorization header. Public endpoints include /, /health, /docs,
    /redoc, and /openapi.json.
  title: AgentArea API
  version: 0.1.0
servers: []
security:
  - bearer: []
paths:
  /v1/workspace/export:
    get:
      tags:
        - v1
        - protected
        - workspace-config
      summary: Export Workspace Config
      description: |-
        Export current workspace configuration as YAML.

        This endpoint exports all workspace-scoped resources:
        - Agents (excluding system default agent)
        - MCP server instances
        - Provider configurations

        **Important Notes:**
        - Secrets (API keys, passwords) are replaced with placeholders
        - Built-in/catalog resources (carrying registry_item_id) are excluded
        - Only resources in the current workspace are exported
        - References to specs are included (server_spec_id, provider_spec_id)

        **Returns:**
        YAML file content that can be saved and later imported
      operationId: export_workspace_config_v1_workspace_export_get
      responses:
        '200':
          content:
            text/plain:
              schema:
                type: string
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: JWT Bearer token for authentication
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````