When to use
Enumerate the presentations created by the API key’s user. Returns up to 100 results, ordered bycreatedAt descending.
For full per-presentation metadata (token list, per-token access counts), use GET /getSharedPresentationInfoPublic/{shareId}.
Endpoint
Auth
| Header | Value |
|---|---|
X-Process-Manager-Key | cko_… (or cka_…) |
presentations:read.
Request
No body, no query parameters. The user is inferred from the API key.Response (200)
| Field | Type | Description |
|---|---|---|
id | UUIDv7 string | The shareId |
title | string | Display title |
version | number | Current version |
createdAt, updatedAt, lastViewedAt | ISO 8601 string | null | Timestamps |
archived | boolean | True if archived |
totalViews | number | Sum of views across all share tokens |
shareUrl | string | null | An active share URL (first non-revoked token), or null if archived or no live token |
Pagination
Capped at 100 results in v1. There is no cursor; if you have more than 100 presentations, the list page in the dashboard is the recommended path.Examples
curl
Node.js
Errors
| Status | Code | Cause | Fix |
|---|---|---|---|
401 | unauthenticated | Missing or invalid API key | Set X-Process-Manager-Key |
405 | method-not-allowed | Used POST/PUT/etc. | Use GET |
500 | internal | Backend error | Retry with backoff |
Next
- GET /getSharedPresentationInfoPublic/ — Full metadata for one presentation, including all share tokens.