Workspaces & Spaces
How to organize your documentation with workspaces and spaces.
Workspaces
A workspace is the top-level organizational unit in AgentDocs. It represents a team, company, department, or any group that needs its own documentation hub. Each workspace has:
- A unique name and URL slug (e.g.,
acme-corp) - One or more spaces containing pages
- Its own member list with role-based permissions
- Settings for webhooks, API tokens, and workspace configuration
Creating a Workspace
From the dashboard, click "New Workspace". You'll need to provide:
- Name — A human-readable display name (e.g., "Acme Engineering")
- Slug — A URL-safe identifier used in paths (e.g.,
acme-eng). This cannot be changed after creation.
# Create a workspace via API
curl -X POST https://agentdocs.eu/api/workspaces \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Acme Engineering", "slug": "acme-eng"}'Managing a Workspace
Access workspace settings by clicking the gear icon in the workspace sidebar or navigating to /:workspaceSlug/settings. From here you can:
- Update the workspace name and description
- Manage workspace members and their roles
- Configure webhooks for change notifications
- View your API token for programmatic access
- Delete the workspace (owner only)
Workspace Limits
The number of spaces, pages, and members you can have depends on your plan:
| Limit | Free | Pro Pro |
|---|---|---|
| Spaces per workspace | 2 | Unlimited |
| Pages per space | 50 | Unlimited |
| Members | 2 | Unlimited |
| Webhooks | 1 | Unlimited |
| API calls / month | 10,000 | 1,000,000 |
Upgrade to Pro from your workspace settings → Billing tab to unlock unlimited resources and additional features like PDF export and priority support.
Spaces
A space is a collection of pages within a workspace. Spaces let you group related documentation together. For example, a workspace might contain:
Each space has its own page tree, which is a hierarchical structure of pages. Spaces are identified by a name and a URL slug (e.g., api-docs).
Creating a Space
Inside a workspace, click "New Space" in the sidebar. Provide a name and slug. The space will immediately be available for adding pages.
# Create a space via API
curl -X POST https://agentdocs.eu/api/workspaces/WORKSPACE_ID/spaces \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "API Documentation", "slug": "api-docs"}'Roles & Permissions
AgentDocs uses role-based access control (RBAC) at the workspace level. Each member of a workspace is assigned one of the following roles:
| Role | Permissions |
|---|---|
Owner | Full control. Manage members, settings, billing, spaces, and all pages. Can delete the workspace. One owner per workspace. |
Admin | Manage spaces, pages, share links, and webhooks. Invite/remove members (except owner). Cannot delete the workspace. |
Editor | Create, edit, and delete pages. Create share links. Cannot manage spaces, members, or workspace settings. |
Viewer | Read-only access to all pages and spaces within the workspace. Cannot edit, create, or delete anything. |
⚠️ Note: API token access inherits the permissions of the user who created the token. If you need read-only agent access, use share links instead of API tokens.
URL Structure
AgentDocs uses a clean, hierarchical URL structure:
https://agentdocs.eu/:workspaceSlug → Workspace home https://agentdocs.eu/:workspaceSlug/:spaceSlug/:pageSlug → Page view/editor https://agentdocs.eu/:workspaceSlug/settings → Workspace settings