Introduction
Read and write your organization's knowledge store over REST with an API key
The Stardeck API lets you manage your organization's resources programmatically. Use it to sync content, automate workflows, and integrate Stardeck into your toolchain.
The REST API covers the knowledge store. For everything else, use the org MCP server.
Base URL
https://www.stardeck.ai/api/v1Every request needs an organization API key. See Authentication.
Available APIs
| API | Description |
|---|---|
| Knowledge Store | Create, read, update, and delete knowledge items |
Response Format
All responses follow a consistent envelope:
{
"success": true,
"data": { ... }
}Error responses include a message:
{
"success": false,
"error": "Description of what went wrong",
"details": "Optional additional context"
}Permissions
Each API key is assigned an organization role. The key can only access resources that its role's permissions allow. For knowledge store operations:
| Permission | Grants |
|---|---|
knowledge:read | Read items |
knowledge:write | Create and update items (includes read) |
knowledge:admin | Delete items and manage permissions (includes write) |
Folder-level permission overrides may further restrict access to specific paths.