docs:prompts.title
docs:prompts.desc
docs:prompts.list.title
GET /api/sdk/prompts
docs:prompts.list.queryParams
| docs:prompts.list.param | docs:prompts.list.type | docs:prompts.list.description |
|---|---|---|
| q | string | docs:prompts.list.params.q |
| tag | string | docs:prompts.list.params.tag |
| category | string | docs:prompts.list.params.category |
| limit | number | docs:prompts.list.params.limit |
| offset | number | docs:prompts.list.params.offset |
| sort | string | docs:prompts.list.params.sort |
| order | string | docs:prompts.list.params.order |
docs:prompts.list.response
[
{
"id": 1,
"title": "Marketing Copy Generator",
"content": "Write a copy for {{product}}",
"category": "Marketing",
"tags": "copywriting,marketing",
"versionNumber": 3,
"createdAt": "2024-12-01T10:00:00Z",
"updatedAt": "2024-12-05T15:30:00Z"
}
]docs:prompts.version.title
docs:prompts.version.desc
GET /api/sdk/prompts/:id/version/:versionNumber
curl https://promstack.com/api/sdk/prompts/1/version/2 \
-H "Authorization: Bearer $PROMSTACK_API_KEY"docs:prompts.versions.title
NEWdocs:prompts.versions.desc
GET /api/sdk/prompts/:id/versions
docs:prompts.list.response
[
{
"id": 3,
"promptId": 1,
"versionNumber": 3,
"title": "Marketing Copy v3",
"content": "Write a copy for {{product}}.",
"createdAt": "2024-12-05T15:30:00Z",
"createdBy": 1
},
{
"id": 2,
"promptId": 1,
"versionNumber": 2,
"title": "Marketing Copy v2",
"content": "Write {{product}} copy.",
"createdAt": "2024-12-03T10:00:00Z",
"createdBy": 1
}
]docs:prompts.sdk.title
TypeScript
// List prompts
const prompts = await client.getPrompts({
category: 'marketing',
tag: 'copywriting',
sort: 'updated',
order: 'desc'
});
// Get specific version
const v2 = await client.getPromptVersion(1, 2);
// Get all versions
const versions = await client.getPromptVersions(1);
// Get categories/tags
const categories = await client.getCategories();
const tags = await client.getTags();
// Search
const result = await client.searchPrompts('marketing', { limit: 10 });
console.log(`Total ${result.total}, returned ${result.prompts.length}`);