case_timelines

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

Overview

Name	case_timelines
Type	Resource
Id	datadog.service_management.case_timelines

Fields

The following fields are returned by SELECT queries:

list_case_timeline

Name	Datatype	Description
id	string	Timeline cell's identifier (example: aeadc05e-98a8-11ec-ac2c-da7ad0900001)
attributes	object	Attributes of a timeline cell, representing a single event in a case's chronological activity log (for example, a comment, status change, or assignment update).
type	string	JSON:API resource type for timeline cells. (timeline_cell) (default: timeline_cell, example: timeline_cell)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_case_timeline	select	case_id	page[size], page[number], sort[ascending]	Returns the timeline of events for a case, including comments, status changes, and other activity. Supports pagination and sort order.

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
case_id	string	Case's UUID or key (example: f98a5a5b-e0ff-45d4-b2f5-afe6e74de504)
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.
page[number]	integer (int64)	Zero-based page number for pagination.
page[size]	integer (int64)	Number of timeline cells to return per page.
sort[ascending]	boolean	If true, returns timeline cells in chronological order (oldest first). Defaults to false (newest first).

SELECT examples

list_case_timeline

Returns the timeline of events for a case, including comments, status changes, and other activity. Supports pagination and sort order.

SELECT
id,
attributes,
type
FROM datadog.service_management.case_timelines
WHERE case_id = '{{ case_id }}' -- required
AND page[size] = '{{ page[size] }}'
AND page[number] = '{{ page[number] }}'
AND sort[ascending] = '{{ sort[ascending] }}'
;