REST API
History, presets, and Prompt Library
Read workflow history, store reusable variable values, and manage Prompt Library content.
Verified against the implementation ·
Workflow history
| Method | Path | Purpose |
|---|---|---|
| GET | /history?type=generation|optimization|refinement | List history; supports search, limit up to 100, and offset |
| GET | /history/{type}/{id} | Read complete history detail |
| PATCH | /history/{type}/{id} | Rename an owned history item |
| DELETE | /history/{type}/{id} | Delete an owned history item |
Prompt presets
Presets pair a reusable prompt template with saved variable values. Each preset can contain up to 100 variables and each value can contain up to 10,000 characters.
{
"name": "Weekly launch brief",
"templateTitle": "Product launch plan",
"promptText": "Create a launch plan for {{product}} aimed at {{audience}}.",
"values": {
"product": "a privacy-first budgeting app",
"audience": "freelance designers"
}
}Use GET/POST /prompt-presets, GET/PATCH/DELETE /prompt-presets/{id}, and POST /prompt-presets/{id}/render.
Prompt Library
| List parameter | Rules |
|---|---|
| scope | my (default), community, official, saved, or upvoted |
| query | Optional search text up to 200 characters |
| category | Optional category up to 120 characters |
| models | Optional comma-separated model names |
| sort | recent (default) or top |
| page / pageSize | Page starts at 1; pageSize is 1–30 and defaults to 30 |
- Create items as private first with POST /library/items.
- Read accessible private, community, official, saved, and upvoted content.
- Update or delete only items owned by the authenticated account.
- Publish an owned item with POST /library/items/{id}/publish; unpublish it with DELETE on the same path.
- Toggle saved state with POST /library/items/{id}/saved and votes with POST /library/items/{id}/vote.
- Publishing is restricted to paid plans, and content blocked by moderation cannot be republished.
Publishing is an external action
Publishing makes an owned prompt visible in Community Prompts. Ask for explicit user confirmation before an autonomous agent invokes this action.