projects

Creates, updates, deletes, gets or lists a projects resource.

Overview

Name	projects
Type	Resource
Id	datadog.llm_observability.projects

Fields

The following fields are returned by SELECT queries:

list_llmobs_projects

Name	Datatype	Description
id	string	Unique identifier of the project. (example: a33671aa-24fd-4dcd-9b33-a8ec7dde7751)
attributes	object	Attributes of an Agent Observability project.
type	string	Resource type of an Agent Observability project. (projects) (example: projects)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_llmobs_projects	select		filter[id], filter[name], page[cursor], page[limit]	List all Agent Observability projects sorted by creation date, newest first.
create_llmobs_project	insert	data		Create a new Agent Observability project. Returns the existing project if a name conflict occurs.
update_llmobs_project	update	project_id, data		Partially update an existing Agent Observability project.
delete_llmobs_projects	exec	data		Delete one or more Agent Observability projects.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
project_id	string	The ID of the Agent Observability project. (example: a33671aa-24fd-4dcd-9b33-a8ec7dde7751)
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
filter[id]	string	Filter projects by project ID.
filter[name]	string	Filter projects by name.
page[cursor]	string	Use the Pagination cursor to retrieve the next page of results.
page[limit]	integer (int64)	Maximum number of results to return per page.

SELECT examples

list_llmobs_projects

List all Agent Observability projects sorted by creation date, newest first.

SELECT
id,
attributes,
type
FROM datadog.llm_observability.projects
WHERE filter[id] = '{{ filter[id] }}'
AND filter[name] = '{{ filter[name] }}'
AND page[cursor] = '{{ page[cursor] }}'
AND page[limit] = '{{ page[limit] }}'
;

INSERT examples

create_llmobs_project

Create a new Agent Observability project. Returns the existing project if a name conflict occurs.

INSERT INTO datadog.llm_observability.projects (
data
)
SELECT 
'{{ data }}' /* required */
RETURNING
data
;

Manifest

# Description fields are for documentation purposes
- name: projects
props:
  - name: data
    description: |
      Data object for creating an Agent Observability project.
    value:
      attributes:
        description: "{{ description }}"
        name: "{{ name }}"
      type: "{{ type }}"

UPDATE examples

update_llmobs_project

Partially update an existing Agent Observability project.

UPDATE datadog.llm_observability.projects
SET 
data = '{{ data }}'
WHERE 
project_id = '{{ project_id }}' --required
AND data = '{{ data }}' --required
RETURNING
data;

Lifecycle Methods

EXEC variables use wire (API) names.

delete_llmobs_projects

Delete one or more Agent Observability projects.

EXEC datadog.llm_observability.projects.delete_llmobs_projects 
@@json=
'{
"data": "{{ data }}"
}'
;