List prompts | Runtype Documentation

curl https://api.runtype.com/v1/prompts \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "createdAt": "2024-06-10T09:15:00Z",
      "estimatedCost": "0.0025",
      "estimatedTokens": 150,
      "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
      "model": "gpt-4-turbo",
      "name": "Customer Support Reply",
      "responseFormat": "json",
      "text": "Generate a polite and concise response to a customer inquiry about order status.",
      "updatedAt": "2024-06-12T14:20:00Z",
      "order": 1,
      "systemPrompt": "You are a helpful assistant providing customer support.",
      "userId": "user_987654321",
      "userPrompt": "Write a response to a customer asking about their order delivery date."
    }
  ],
  "filtersApplied": {},
  "pagination": {
    "currentOffset": 0,
    "hasMore": true,
    "hasPrev": false,
    "limit": 50,
    "nextCursor": "cursor_123abc",
    "prevCursor": null,
    "currentPage": 1,
    "totalCount": 120,
    "totalPages": 3
  }
}

Returns prompts for the authenticated user, optionally filtered by flow, search, or model.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

flowIdstringOptional

Filter prompts by flow ID

limitstringOptional

Max results per page (default 50, max 100)

cursorstringOptional

Pagination cursor

directionenumOptional

Pagination direction

Allowed values:

searchstringOptional

Search by name or text

modelstringOptional

Filter by model ID

Response

List of prompts

datalist of objects

filtersAppliedmap from strings to any

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/prompts \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"

1	{
2	"data": [
3	{
4	"createdAt": "2024-06-10T09:15:00Z",
5	"estimatedCost": "0.0025",
6	"estimatedTokens": 150,
7	"id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
8	"model": "gpt-4-turbo",
9	"name": "Customer Support Reply",
10	"responseFormat": "json",
11	"text": "Generate a polite and concise response to a customer inquiry about order status.",
12	"updatedAt": "2024-06-12T14:20:00Z",
13	"order": 1,
14	"systemPrompt": "You are a helpful assistant providing customer support.",
15	"userId": "user_987654321",
16	"userPrompt": "Write a response to a customer asking about their order delivery date."
17	}
18	],
19	"filtersApplied": {},
20	"pagination": {
21	"currentOffset": 0,
22	"hasMore": true,
23	"hasPrev": false,
24	"limit": 50,
25	"nextCursor": "cursor_123abc",
26	"prevCursor": null,
27	"currentPage": 1,
28	"totalCount": 120,
29	"totalPages": 3
30	}
31	}