List Versions of a Prompt

GET

Get a list of all the versions of a Prompt.

Path parameters

idstringRequired

Unique identifier for Prompt.

Query parameters

statusenumOptional

Filter versions by status: ‘uncommitted’, ‘committed’. If no status is provided, all versions are returned.

Allowed values: uncommittedcommitteddeleted

evaluator_aggregatesbooleanOptional

Whether to include Evaluator aggregate results for the versions in the response

Response

Successful Response

recordslist of objects

The list of Prompts.

Errors

GET

1 curl -G https://api.humanloop.com/v5/prompts/pr_30gco7dx6JDq4200GVOHa/versions \
2      -H "X-API-KEY: <apiKey>" \
3      -d status=committed

1 {
2   "records": [
3     {
4       "path": "Personal Projects/Coding Assistant",
5       "id": "pr_30gco7dx6JDq4200GVOHa",
6       "model": "gpt-4o",
7       "name": "Coding Assistant",
8       "version_id": "prv_7ZlQREDScH0xkhUwtXruN",
9       "created_at": "2024-07-08T22:40:35.656915",
10       "updated_at": "2024-07-08T22:40:35.656915",
11       "status": "committed",
12       "last_used_at": "2024-07-08T22:40:35.656915",
13       "version_logs_count": 0,
14       "total_logs_count": 0,
15       "inputs": [
16         {
17           "name": "messages"
18         }
19       ],
20       "endpoint": "chat",
21       "template": [
22         {
23           "content": "You are a helpful coding assistant specialising in {{language}}",
24           "role": "system"
25         }
26       ],
27       "provider": "openai",
28       "max_tokens": -1,
29       "temperature": 0.7,
30       "top_p": 1,
31       "presence_penalty": 0,
32       "frequency_penalty": 0,
33       "other": {},
34       "tools": [],
35       "linked_tools": [],
36       "commit_message": "Initial commit",
37       "type": "prompt",
38       "environments": [
39         {
40           "id": "env_ffSVxEBzJcBZ1H5jcNMVj",
41           "created_at": "2023-06-27T23:16:07.992339",
42           "name": "development",
43           "tag": "default"
44         }
45       ],
46       "created_by": {
47         "id": "usr_01RJO1k2spBVqNUt1ASef",
48         "email_address": "raza@humanloop.com",
49         "full_name": "Raza Habib"
50       }
51     }
52   ]
53 }

Commit a Prompt Version

Up Next

Built with

1	curl -G https://api.humanloop.com/v5/prompts/pr_30gco7dx6JDq4200GVOHa/versions \
2	-H "X-API-KEY: <apiKey>" \
3	-d status=committed

1	{
2	"records": [
3	{
4	"path": "Personal Projects/Coding Assistant",
5	"id": "pr_30gco7dx6JDq4200GVOHa",
6	"model": "gpt-4o",
7	"name": "Coding Assistant",
8	"version_id": "prv_7ZlQREDScH0xkhUwtXruN",
9	"created_at": "2024-07-08T22:40:35.656915",
10	"updated_at": "2024-07-08T22:40:35.656915",
11	"status": "committed",
12	"last_used_at": "2024-07-08T22:40:35.656915",
13	"version_logs_count": 0,
14	"total_logs_count": 0,
15	"inputs": [
16	{
17	"name": "messages"
18	}
19	],
20	"endpoint": "chat",
21	"template": [
22	{
23	"content": "You are a helpful coding assistant specialising in {{language}}",
24	"role": "system"
25	}
26	],
27	"provider": "openai",
28	"max_tokens": -1,
29	"temperature": 0.7,
30	"top_p": 1,
31	"presence_penalty": 0,
32	"frequency_penalty": 0,
33	"other": {},
34	"tools": [],
35	"linked_tools": [],
36	"commit_message": "Initial commit",
37	"type": "prompt",
38	"environments": [
39	{
40	"id": "env_ffSVxEBzJcBZ1H5jcNMVj",
41	"created_at": "2023-06-27T23:16:07.992339",
42	"name": "development",
43	"tag": "default"
44	}
45	],
46	"created_by": {
47	"id": "usr_01RJO1k2spBVqNUt1ASef",
48	"email_address": "raza@humanloop.com",
49	"full_name": "Raza Habib"
50	}
51	}
52	]
53	}