Note : This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support .
POST https://api.ap1.datadoghq.com/api/v2/incidents/config/postmortem-templates https://api.ap2.datadoghq.com/api/v2/incidents/config/postmortem-templates https://api.datadoghq.eu/api/v2/incidents/config/postmortem-templates https://api.ddog-gov.com/api/v2/incidents/config/postmortem-templates https://api.us2.ddog-gov.com/api/v2/incidents/config/postmortem-templates https://api.datadoghq.com/api/v2/incidents/config/postmortem-templates https://api.us3.datadoghq.com/api/v2/incidents/config/postmortem-templates https://api.us5.datadoghq.com/api/v2/incidents/config/postmortem-templates
Overview Create a new postmortem template for incidents.
Request Body Data (required)
Expand All
Data object for creating or updating a postmortem template.
Attributes for creating or updating a postmortem template.
Postmortem template resource type
Allowed enum values: postmortem_template
{
"data" : {
"attributes" : {
"name" : "Standard Postmortem Template"
},
"type" : "postmortem_template"
}
} Response Created
Response containing a single postmortem template.
Expand All
Data object for a postmortem template returned in a response.
Attributes of a postmortem template returned in a response.
When the template was created
When the template was last modified
Postmortem template resource type
Allowed enum values: postmortem_template
{
"data" : {
"attributes" : {
"createdAt" : "2026-01-13T17:15:53.208340Z" ,
"modifiedAt" : "2026-01-13T17:15:53.208340Z" ,
"name" : "Standard Postmortem Template"
},
"id" : "template-456" ,
"type" : "postmortem_template"
}
} Bad Request
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors" : [
{
"detail" : "Missing required attribute in body" ,
"meta" : {},
"source" : {
"header" : "Authorization" ,
"parameter" : "limit" ,
"pointer" : "/data/attributes/title"
},
"status" : "400" ,
"title" : "Bad Request"
}
]
} Forbidden
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors" : [
{
"detail" : "Missing required attribute in body" ,
"meta" : {},
"source" : {
"header" : "Authorization" ,
"parameter" : "limit" ,
"pointer" : "/data/attributes/title"
},
"status" : "400" ,
"title" : "Bad Request"
}
]
} Too many requests
{
"errors" : [
"Bad Request"
]
} Code Example Copy
## default
#
# Curl command curl -X POST "https://api.ap1.datadoghq.com "https://api.ap2.datadoghq.com "https://api.datadoghq.eu "https://api.ddog-gov.com "https://api.us2.ddog-gov.com "https://api.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v2/incidents/config/postmortem-templates " \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} " \
-d @- << EOF
{
"data": {
"attributes": {
"name": "Standard Postmortem Template"
},
"type": "postmortem_template"
}
}
EOF
"""
Create postmortem template returns "Created" response
"""
from datadog_api_client import ApiClient , Configuration
from datadog_api_client.v2.api.incidents_api import IncidentsApi
from datadog_api_client.v2.model.postmortem_template_attributes_request import PostmortemTemplateAttributesRequest
from datadog_api_client.v2.model.postmortem_template_data_request import PostmortemTemplateDataRequest
from datadog_api_client.v2.model.postmortem_template_request import PostmortemTemplateRequest
from datadog_api_client.v2.model.postmortem_template_type import PostmortemTemplateType
body = PostmortemTemplateRequest (
data = PostmortemTemplateDataRequest (
attributes = PostmortemTemplateAttributesRequest (
name = "Standard Postmortem Template" ,
),
type = PostmortemTemplateType . POSTMORTEM_TEMPLATE ,
),
)
configuration = Configuration ()
configuration . unstable_operations [ "create_incident_postmortem_template" ] = True
with ApiClient ( configuration ) as api_client :
api_instance = IncidentsApi ( api_client )
response = api_instance . create_incident_postmortem_template ( body = body )
print ( response )
Instructions First install the library and its dependencies and then save the example to example.py and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" python3 "example.py"
# Create postmortem template returns "Created" response
require "datadog_api_client"
DatadogAPIClient . configure do | config |
config . unstable_operations [ "v2.create_incident_postmortem_template" . to_sym ] = true
end
api_instance = DatadogAPIClient :: V2 :: IncidentsAPI . new
body = DatadogAPIClient :: V2 :: PostmortemTemplateRequest . new ({
data : DatadogAPIClient :: V2 :: PostmortemTemplateDataRequest . new ({
attributes : DatadogAPIClient :: V2 :: PostmortemTemplateAttributesRequest . new ({
name : "Standard Postmortem Template" ,
}),
type : DatadogAPIClient :: V2 :: PostmortemTemplateType :: POSTMORTEM_TEMPLATE ,
}),
})
p api_instance . create_incident_postmortem_template ( body )
Instructions First install the library and its dependencies and then save the example to example.rb and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" rb "example.rb"
// Create postmortem template returns "Created" 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 () {
body := datadogV2 . PostmortemTemplateRequest {
Data : datadogV2 . PostmortemTemplateDataRequest {
Attributes : datadogV2 . PostmortemTemplateAttributesRequest {
Name : "Standard Postmortem Template" ,
},
Type : datadogV2 . POSTMORTEMTEMPLATETYPE_POSTMORTEM_TEMPLATE ,
},
}
ctx := datadog . NewDefaultContext ( context . Background ())
configuration := datadog . NewConfiguration ()
configuration . SetUnstableOperationEnabled ( "v2.CreateIncidentPostmortemTemplate" , true )
apiClient := datadog . NewAPIClient ( configuration )
api := datadogV2 . NewIncidentsApi ( apiClient )
resp , r , err := api . CreateIncidentPostmortemTemplate ( ctx , body )
if err != nil {
fmt . Fprintf ( os . Stderr , "Error when calling `IncidentsApi.CreateIncidentPostmortemTemplate`: %v\n" , err )
fmt . Fprintf ( os . Stderr , "Full HTTP response: %v\n" , r )
}
responseContent , _ := json . MarshalIndent ( resp , "" , " " )
fmt . Fprintf ( os . Stdout , "Response from `IncidentsApi.CreateIncidentPostmortemTemplate`:\n%s\n" , responseContent )
}
Instructions First install the library and its dependencies and then save the example to main.go and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" go run "main.go"
// Create postmortem template returns "Created" response
import com.datadog.api.client.ApiClient ;
import com.datadog.api.client.ApiException ;
import com.datadog.api.client.v2.api.IncidentsApi ;
import com.datadog.api.client.v2.model.PostmortemTemplateAttributesRequest ;
import com.datadog.api.client.v2.model.PostmortemTemplateDataRequest ;
import com.datadog.api.client.v2.model.PostmortemTemplateRequest ;
import com.datadog.api.client.v2.model.PostmortemTemplateResponse ;
import com.datadog.api.client.v2.model.PostmortemTemplateType ;
public class Example {
public static void main ( String [] args ) {
ApiClient defaultClient = ApiClient . getDefaultApiClient ();
defaultClient . setUnstableOperationEnabled ( "v2.createIncidentPostmortemTemplate" , true );
IncidentsApi apiInstance = new IncidentsApi ( defaultClient );
PostmortemTemplateRequest body =
new PostmortemTemplateRequest ()
. data (
new PostmortemTemplateDataRequest ()
. attributes (
new PostmortemTemplateAttributesRequest ()
. name ( "Standard Postmortem Template" ))
. type ( PostmortemTemplateType . POSTMORTEM_TEMPLATE ));
try {
PostmortemTemplateResponse result = apiInstance . createIncidentPostmortemTemplate ( body );
System . out . println ( result );
} catch ( ApiException e ) {
System . err . println ( "Exception when calling IncidentsApi#createIncidentPostmortemTemplate" );
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 and then save the example to Example.java and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" java "Example.java"
// Create postmortem template returns "Created" response
use datadog_api_client ::datadog ;
use datadog_api_client ::datadogV2 ::api_incidents ::IncidentsAPI ;
use datadog_api_client ::datadogV2 ::model ::PostmortemTemplateAttributesRequest ;
use datadog_api_client ::datadogV2 ::model ::PostmortemTemplateDataRequest ;
use datadog_api_client ::datadogV2 ::model ::PostmortemTemplateRequest ;
use datadog_api_client ::datadogV2 ::model ::PostmortemTemplateType ;
#[tokio::main]
async fn main () {
let body = PostmortemTemplateRequest ::new ( PostmortemTemplateDataRequest ::new (
PostmortemTemplateAttributesRequest ::new ( "Standard Postmortem Template" . to_string ()),
PostmortemTemplateType ::POSTMORTEM_TEMPLATE ,
));
let mut configuration = datadog ::Configuration ::new ();
configuration . set_unstable_operation_enabled ( "v2.CreateIncidentPostmortemTemplate" , true );
let api = IncidentsAPI ::with_config ( configuration );
let resp = api . create_incident_postmortem_template ( body ). await ;
if let Ok ( value ) = resp {
println! ( " {:#?} " , value );
} else {
println! ( " {:#?} " , resp . unwrap_err ());
}
}
Instructions First install the library and its dependencies and then save the example to src/main.rs and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" cargo run
/**
* Create postmortem template returns "Created" response
*/
import { client , v2 } from "@datadog/datadog-api-client" ;
const configuration = client . createConfiguration ();
configuration . unstableOperations [ "v2.createIncidentPostmortemTemplate" ] = true ;
const apiInstance = new v2 . IncidentsApi ( configuration );
const params : v2.IncidentsApiCreateIncidentPostmortemTemplateRequest = {
body : {
data : {
attributes : {
name : "Standard Postmortem Template" ,
},
type : "postmortem_template" ,
},
},
};
apiInstance
. createIncidentPostmortemTemplate ( params )
. then (( data : v2.PostmortemTemplateResponse ) => {
console . log (
"API called successfully. Returned data: " + JSON . stringify ( data )
);
})
. catch (( error : any ) => console . error ( error ));
Instructions First install the library and its dependencies and then save the example to example.ts and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ap2.datadoghq.com ddog-gov.com us2.ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" tsc "example.ts"