> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardeck.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Programmatic access to your Stardeck organization's resources

The Stardeck API lets you manage your organization's resources programmatically. Use it to sync content, automate workflows, and integrate Stardeck into your toolchain.

## Base URL

```
https://www.stardeck.ai/api/v1
```

## Available APIs

| API                                              | Description                                      |
| ------------------------------------------------ | ------------------------------------------------ |
| [Knowledge Store](/api-reference/knowledge/list) | Create, read, update, and delete knowledge items |

## Response Format

All responses follow a consistent envelope:

```json theme={null}
{
  "success": true,
  "data": { ... }
}
```

Error responses include a message:

```json theme={null}
{
  "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.