--- title: List versions of an Agent Observability prompt description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Agent Observability --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # List versions of an Agent Observability prompt{% #list-versions-of-an-agent-observability-prompt %} Copy pageCopied {% tab title="v2" %} **Note**: This endpoint is in preview and is subject to change. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------------------------------- | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/llm-obs/v1/prompts/{prompt_id}/versions | ### Overview List all versions of an Agent Observability prompt, ordered newest to oldest. If the prompt does not exist, is not registered, or is archived, the response contains an empty list. This endpoint requires the `llm_observability_read` permission. ### Arguments #### Path Parameters | Name | Type | Description | | --------------------------- | ------ | ------------------------------------------------------------------- | | prompt_id [*required*] | string | The customer-provided identifier of the Agent Observability prompt. | ### Response {% tab title="200" %} OK {% tab title="Model" %} Response containing the versions of an Agent Observability prompt. | Parent field | Field | Type | Description | | ------------ | ----------------------------- | --------- | ------------------------------------------------------------------------------------------------------- | | | data [*required*] | [object] | Prompt versions ordered from newest to oldest. | | data | attributes [*required*] | object | Attributes of a prompt version returned in a list, excluding its template. | | attributes | author | string | UUID of the user who authored this version. | | attributes | created_at | date-time | Timestamp stored on this prompt version. | | attributes | datasets | [object] | Datasets observed in runs associated with this prompt version. | | datasets | id [*required*] | string | Unique identifier of the dataset. | | datasets | name | string | Name of the dataset. | | attributes | description | string | Description of this version. | | attributes | labels | [string] | **DEPRECATED**: Labels attached to this version (for example `development`, `staging`, `production`). | | attributes | last_seen_at | date-time | Timestamp of the most recent observed run of this prompt version. | | attributes | ml_app | string | The ML application this prompt is associated with. | | attributes | ml_apps | [string] | ML applications observed running this prompt version. | | attributes | prompt_id [*required*] | string | Customer-provided identifier of the parent prompt. | | attributes | prompt_uuid [*required*] | string | Unique identifier of the parent prompt. | | attributes | tags | [string] | Tags observed on runs of this prompt version. | | attributes | user_version | string | User-supplied identifier for this version. | | attributes | version [*required*] | int64 | Sequential version number. | | attributes | version_created_at | date-time | Timestamp when this version was created. | | data | id [*required*] | string | Unique identifier of the prompt version. | | data | type [*required*] | enum | Resource type of an Agent Observability prompt version. Allowed enum values: `prompt-template-versions` | {% /tab %} {% tab title="Example" %} ```json { "data": [ { "attributes": { "author": "3b12f1df-14fd-4e12-bd6f-4a2f5c8b3d1e", "created_at": "2025-02-01T14:30:00Z", "description": "Give concise answers and cite relevant help-center articles.", "prompt_id": "customer-support-assistant", "prompt_uuid": "4a1a28ff-8a25-5f0f-946f-f48264d772eb", "version": 2, "version_created_at": "2025-02-01T14:30:00Z" }, "id": "d83ab666-61cc-5545-a83b-2424bb85467b", "type": "prompt-template-versions" }, { "attributes": { "author": "3b12f1df-14fd-4e12-bd6f-4a2f5c8b3d1e", "created_at": "2025-01-15T10:00:00Z", "description": "Initial customer support prompt.", "prompt_id": "customer-support-assistant", "prompt_uuid": "4a1a28ff-8a25-5f0f-946f-f48264d772eb", "version": 1, "version_created_at": "2025-01-15T10:00:00Z" }, "id": "20e5280b-c75d-5699-8a70-a2773a751428", "type": "prompt-template-versions" } ] } ``` {% /tab %} {% /tab %} {% tab title="401" %} Unauthorized {% tab title="Model" %} API error response. | Parent field | Field | Type | Description | | ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- | | | errors [*required*] | [object] | A list of errors. | | errors | detail | string | A human-readable explanation specific to this occurrence of the error. | | errors | meta | object | Non-standard meta-information about the error | | errors | source | object | References to the source of the error. | | source | header | string | A string indicating the name of a single request header which caused the error. | | source | parameter | string | A string indicating which URI query parameter caused the error. | | source | pointer | string | A JSON pointer to the value in the request document that caused the error. | | errors | status | string | Status code of the response. | | errors | title | string | Short human-readable summary of the error. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "detail": "Missing required attribute in body", "meta": {}, "source": { "header": "Authorization", "parameter": "limit", "pointer": "/data/attributes/title" }, "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Forbidden {% tab title="Model" %} API error response. | Parent field | Field | Type | Description | | ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- | | | errors [*required*] | [object] | A list of errors. | | errors | detail | string | A human-readable explanation specific to this occurrence of the error. | | errors | meta | object | Non-standard meta-information about the error | | errors | source | object | References to the source of the error. | | source | header | string | A string indicating the name of a single request header which caused the error. | | source | parameter | string | A string indicating which URI query parameter caused the error. | | source | pointer | string | A JSON pointer to the value in the request document that caused the error. | | errors | status | string | Status code of the response. | | errors | title | string | Short human-readable summary of the error. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "detail": "Missing required attribute in body", "meta": {}, "source": { "header": "Authorization", "parameter": "limit", "pointer": "/data/attributes/title" }, "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Path parameters export prompt_id="customer-support-assistant" \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/llm-obs/v1/prompts/${prompt_id}/versions" \ -H "Accept: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" ##### ```python """ List versions of an Agent Observability prompt returns "OK" response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.agent_observability_api import AgentObservabilityApi configuration = Configuration() configuration.unstable_operations["list_llm_obs_prompt_versions"] = True with ApiClient(configuration) as api_client: api_instance = AgentObservabilityApi(api_client) response = api_instance.list_llm_obs_prompt_versions( prompt_id="prompt_id", ) print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby # List versions of an Agent Observability prompt returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.unstable_operations["v2.list_llm_obs_prompt_versions".to_sym] = true end api_instance = DatadogAPIClient::V2::AgentObservabilityAPI.new p api_instance.list_llm_obs_prompt_versions("prompt_id") ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```go // List versions of an Agent Observability prompt returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() configuration.SetUnstableOperationEnabled("v2.ListLLMObsPromptVersions", true) apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewAgentObservabilityApi(apiClient) resp, r, err := api.ListLLMObsPromptVersions(ctx, "prompt_id") if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `AgentObservabilityApi.ListLLMObsPromptVersions`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `AgentObservabilityApi.ListLLMObsPromptVersions`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```java // List versions of an Agent Observability prompt returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.AgentObservabilityApi; import com.datadog.api.client.v2.model.LLMObsPromptVersionsResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setUnstableOperationEnabled("v2.listLLMObsPromptVersions", true); AgentObservabilityApi apiInstance = new AgentObservabilityApi(defaultClient); try { LLMObsPromptVersionsResponse result = apiInstance.listLLMObsPromptVersions("customer-support-assistant"); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgentObservabilityApi#listLLMObsPromptVersions"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```rust // List versions of an Agent Observability prompt returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_agent_observability::AgentObservabilityAPI; #[tokio::main] async fn main() { let mut configuration = datadog::Configuration::new(); configuration.set_unstable_operation_enabled("v2.ListLLMObsPromptVersions", true); let api = AgentObservabilityAPI::with_config(configuration); let resp = api .list_llm_obs_prompt_versions("prompt_id".to_string()) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * List versions of an Agent Observability prompt returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); configuration.unstableOperations["v2.listLLMObsPromptVersions"] = true; const apiInstance = new v2.AgentObservabilityApi(configuration); const params: v2.AgentObservabilityApiListLLMObsPromptVersionsRequest = { promptId: "prompt_id", }; apiInstance .listLLMObsPromptVersions(params) .then((data: v2.LLMObsPromptVersionsResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}