List Versions of a Prompt

GET

https://api.humanloop.com/v5/prompts/:id/versions

GET

/v5/prompts/:id/versions

1 from humanloop import Humanloop
2 client = Humanloop(api_key="YOUR_API_KEY", )
3 client.prompts.list_versions(id='pr_30gco7dx6JDq4200GVOHa', )

Try it

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       "last_used_at": "2024-07-08T22:40:35.656915",
12       "version_logs_count": 0,
13       "total_logs_count": 0,
14       "inputs": [
15         {
16           "name": "messages"
17         }
18       ],
19       "endpoint": "chat",
20       "template": [
21         {
22           "content": "You are a helpful coding assistant specialising in {{language}}",
23           "role": "system"
24         }
25       ],
26       "provider": "openai",
27       "max_tokens": -1,
28       "temperature": 0.7,
29       "version_name": "coding-assistant-v1",
30       "version_description": "Initial version",
31       "type": "prompt",
32       "environments": [
33         {
34           "id": "env_ffSVxEBzJcBZ1H5jcNMVj",
35           "created_at": "2023-06-27T23:16:07.992339",
36           "name": "development",
37           "tag": "default"
38         }
39       ],
40       "created_by": {
41         "id": "usr_01RJO1k2spBVqNUt1ASef",
42         "email_address": "raza@humanloop.com",
43         "full_name": "Raza Habib"
44       },
45       "evaluator_aggregates": null
46     }
47   ]
48 }

Get a list of all the versions of a Prompt.

Authentication

X-API-KEYstring

API Key authentication via header

Path Parameters

idstringRequired

Unique identifier for Prompt.

Query Parameters

evaluator_aggregatesbooleanOptional

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

Response

Successful Response

recordslist of objects

The list of Prompts.

Authentication

Path Parameters

Query Parameters

Response

Errors