DAdatadog
Agent Observability

Create a new Agent Observability prompt version

Create a new version of an existing Agent Observability prompt.

Preview: Prompt composition is available in Preview. To request access, contact Datadog Support or your Customer Success Manager.

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

Request

Path parameters

prompt_idstring required

The customer-provided identifier of the Agent Observability prompt.

Request body

Example request

{
  "data": {
    "attributes": {
      "config": {
        "model": "provider-model",
        "response_format": {
          "type": "json_object"
        },
        "temperature": 0.2
      },
      "template": [
        {
          "content": "You are a helpful customer support assistant for {{company_name}}.",
          "role": "system"
        }
      ]
    },
    "type": "prompt-template-versions"
  }
}

Response

OK

Example response

{
  "data": {
    "attributes": {
      "author": "3b12f1df-14fd-4e12-bd6f-4a2f5c8b3d1e",
      "config": {},
      "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",
      "template": [
        {
          "content": "You are a helpful customer support assistant for {{company_name}}.",
          "role": "system"
        },
        {
          "content": "Help {{customer_name}} with this question: {{question}}",
          "role": "user"
        }
      ],
      "version": 2,
      "version_created_at": "2025-02-01T14:30:00Z"
    },
    "id": "d83ab666-61cc-5545-a83b-2424bb85467b",
    "type": "prompt-template-versions"
  }
}

Changes

Changes to this operation have not been checked yet.