Agent Observability

List versions of an Agent Observability prompt

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.

get/api/v2/llm-obs/v1/prompts/{prompt_id}/versions

Request

Base URL
https://api.datadoghq.com
Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2
  Authorization code/oauth2/v1/authorize
  Token URL/oauth2/v1/token
TypeScript
https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/llm-obs/v1/prompts/:prompt_id/versions/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

prompt_idstring required

The customer-provided identifier of the Agent Observability prompt.

Response

Example response

{
  "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"
    }
  ]
}

Changes

Changes to this operation have not been checked yet.