> For the complete documentation index, see [llms.txt](https://docs.taskade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taskade.com/developers/comprehensive-api-guide/folders.md).

# Folders

Folders — Taskade REST API v1 reference: list the projects, agents, media, and templates in a folder, and create or generate agents in a folder.

{% hint style="info" %}
**Generated reference:** This reference is also at [taskade.com/docs/rest](https://www.taskade.com/docs/rest), generated from the live OpenAPI spec. AI agents can do most of this work through the [hosted Taskade MCP server](https://docs.taskade.com/developers/workspace-mcp/genesis-app-mcp.md).
{% endhint %}

A **Subspace** is the top-level container for every AI-powered application you build on Taskade. It's more than just a folder; it's the complete, self-contained ecosystem for your app, holding its own Memory (projects), Intelligence (agents), and Execution (automations).

When you generate an app or create one manually, you are creating a Subspace. Everything related to that app—its data (Projects), its logic (Agents), and its workflows (Automations)—is organized within it.

The API calls a Subspace a folder, so each endpoint below takes a `folderId`. These endpoints manage the Subspaces in your workspace.

## Summary of Endpoints

### Get Folder Projects

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/folders/{folderId}/projects" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Generate Agent in Folder

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/folders/{folderId}/agent-generate" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Create Agent in Folder

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/folders/{folderId}/agents" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Folder Agents

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/folders/{folderId}/agents" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Folder Media

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/folders/{folderId}/medias" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Folder Project Templates

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/folders/{folderId}/project-templates" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}
