---
title: "Export Workspace Config"
method: GET
path: "/v1/workspace/export"
tags: ["v1", "protected", "workspace-config"]
---

# Export Workspace Config

`GET /v1/workspace/export`

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)

There is no matching import endpoint. Recreating a workspace goes through
the platform toolsets (``agentarea/agents``, ``agentarea/mcp_servers``,
``agentarea/providers``, ``agentarea/skills``, ...) or bundle install,
both of which handle secrets as first-class inputs instead of smuggling
placeholders through a YAML file.

**Returns:**
YAML file content describing the workspace

## Response `200`

Successful Response

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/d20a3eecd894?raw)