Workspaces & spaces
How to organize your documentation with workspaces and spaces.
Workspaces
A workspace is the top level in AgentDocs, usually one per team or company. Each workspace has:
- A name and a unique URL slug (e.g.,
acme-corp) - One or more spaces containing pages
- A member list where each person has a role in each space they belong to
- Settings for billing, storage, members, webhooks and the trash (owner only)
Creating a workspace
From the dashboard, click "New workspace". A free account can own one workspace, and the first-run setup may already have created it. Fill in:
- Name — A human-readable display name (e.g., "Acme Engineering")
- Slug — Lowercase letters, numbers and hyphens, used in every URL (e.g.,
acme-eng). It is filled in from the name and must be unique across AgentDocs. You can't change it in the app; it can only be changed through the API, and changing it breaks every existing link to the workspace.
# Create a workspace via API (uses your account API token).
# A free account that already owns a workspace gets 403 "Tier limit reached".
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
Only the workspace owner can open workspace settings. Click Settings (the gear icon) in the workspace header, or go to /:workspaceSlug/settings. The tabs let you:
- Overview: see counts and recent activity, and export the workspace as a PDF book (Pro)
- Members: invite people to a space by email, change their role, or remove them
- Webhooks: send change notifications to your own endpoints
- Billing and Storage: upgrade to Pro, manage the subscription, and see image storage use
- Trash: restore or permanently delete deleted spaces
You can't rename a workspace in the app; that is API-only. To delete a workspace, use the trash icon on its card on the dashboard. Your account API token is not in workspace settings: open Profile on the dashboard and click Regenerate API Token.
Workspace limits
Limits apply to each workspace according to its plan. Items in the trash do not count.
| Limit | Free | Pro Pro |
|---|---|---|
| Workspaces you can own | 1 | Unlimited |
| Spaces per workspace | 2 | Unlimited |
| Pages per space | 50 | Unlimited |
| Members (including the owner) | 2 | Unlimited |
| Webhooks | 1 | Unlimited |
| Image storage | 50 MB | 5 GB |
| API calls / month (agents) | 10,000 | 1,000,000 |
The workspace count is per account: owning one Pro workspace lets you create more, and each new one starts on Free. Until the owner verifies their email address, a free workspace has lower limits: 1 space, 10 pages per space, no other members, no webhooks, no image uploads and 1,000 API calls a month. API calls from the browser are counted but never blocked.
Upgrade to Pro on the Billing tab of the workspace settings. Pro removes the space, page, member and webhook limits, raises storage to 5 GB and API calls to 1,000,000 a month, and adds PDF export, semantic search and priority support.
Spaces
A space is a group of related pages inside a workspace. For example, a workspace might contain:
Each space has its own page tree, so pages can nest under other pages. A space has a name and a URL slug (e.g., api-docs).
Creating a space
As the workspace owner, click the + next to "Spaces" in the sidebar (or Create space in an empty workspace). Enter a name; the slug is filled in from it and must be unique within the workspace. You can add pages straight away.
# Create a space via API (workspace owner only).
# WORKSPACE_ID is the workspace's UUID: GET /api/workspaces lists yours.
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"}'Deleting and restoring
Deleting a workspace, space or page moves it to the trash, where it stays for 30 days before it is deleted for good. Restore a workspace from Trash on the dashboard, a space from the Trash tab in workspace settings, and a page from the trash icon in the space view. Only the owner can delete or restore workspaces and spaces. Deleting a Pro workspace does not cancel its subscription, so cancel it on the Billing tab first.
Roles and permissions
Each workspace has exactly one owner. Everyone else gets a role per space: admin, editor or viewer. A person can be an editor in one space and a viewer in another, and cannot see spaces they have not been added to. Changing a role on the Members tab changes it in every space that person belongs to.
| Role | Permissions |
|---|---|
Owner | The person who created the workspace. Has admin access to every space, and is the only one who can open workspace settings: create and delete spaces, invite and remove people, change roles, manage webhooks, billing and the trash, and delete the workspace. |
Admin | Everything an editor can do in the space, plus creating and revoking agent tokens (Connect an agent). Through the API, can also add and remove the space's members and change their roles, except the owner's. Cannot create or delete spaces, invite people by email, or manage webhooks or billing. |
Editor | Create, edit, move, delete and restore pages; rename the space; import Markdown; create share links; propose changes and review proposals; comment. Cannot manage members or agent tokens. |
Viewer | Read every page in the space, search, and comment. Cannot edit pages, propose changes or create share links. |
Inviting people
In workspace settings, open Members and click Invite member. Enter an email address and pick a space and a role. AgentDocs emails an invitation link that is valid for seven days. The person signs in or registers with that address, verifies it, and accepts; the member limit is checked at that moment. You can resend or revoke pending invitations on the same tab.
⚠️ Note: Agents act with the permissions of the person whose credential they use. An account API token can do everything you can. A space token works in one space only, with the access chosen when it was created: Read only, Read and propose edits, or Read and edit directly. For read access to a single page, a share link is enough.
URL structure
Every page has a readable URL built from slugs:
https://agentdocs.eu/dashboard → Your workspaces https://agentdocs.eu/:workspaceSlug → Workspace home (first space) https://agentdocs.eu/:workspaceSlug?space=:spaceSlug → A space's page list https://agentdocs.eu/:workspaceSlug/:spaceSlug/:pageSlug → Page view/editor https://agentdocs.eu/:workspaceSlug/activity → Activity feed https://agentdocs.eu/:workspaceSlug/settings → Workspace settings (owner) https://agentdocs.eu/inbox → Your inbox