Create or update service definition

POST {{baseUrl}}/api/v2/services/definitions

Create or update service definition in the Datadog Service Catalog.

Request Body

{"schema-version"=>"v2.1", "dd-service"=>"<string>", "application"=>"<string>", "contacts"=>[{"type"=>"email", "contact"=>"<email>", "name"=>"<string>"}, {"type"=>"email", "contact"=>"<email>", "name"=>"<string>"}], "description"=>"<string>", "integrations"=>{"opsgenie"=>{"service-url"=>"<string>", "region"=>"US"}, "pagerduty"=>{"service-url"=>"<string>"}}, "lifecycle"=>"<string>", "links"=>[{"name"=>"<string>", "type"=>"repo", "url"=>"<string>", "provider"=>"<string>"}, {"name"=>"<string>", "type"=>"runbook", "url"=>"<string>", "provider"=>"<string>"}], "tags"=>["<string>", "<string>"], "team"=>"<string>", "tier"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;attributes&quot;:{&quot;meta&quot;:{&quot;github-html-url&quot;:&quot;\u003cstring\u003e&quot;,&quot;ingested-schema-version&quot;:&quot;\u003cstring\u003e&quot;,&quot;ingestion-source&quot;:&quot;\u003cstring\u003e&quot;,&quot;last-modified-time&quot;:&quot;\u003cstring\u003e&quot;,&quot;origin&quot;:&quot;\u003cstring\u003e&quot;,&quot;origin-detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;warnings&quot;:[{&quot;instance-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;keyword-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;},{&quot;instance-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;keyword-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;}]},&quot;schema&quot;:{&quot;schema-version&quot;:&quot;v1&quot;,&quot;info&quot;:{&quot;dd-service&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;display-name&quot;:&quot;\u003cstring\u003e&quot;,&quot;service-tier&quot;:&quot;\u003cstring\u003e&quot;},&quot;contact&quot;:{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;slack&quot;:&quot;\u003cstring\u003e&quot;},&quot;extensions&quot;:{&quot;Excepteur__84&quot;:{},&quot;sit6cc&quot;:{}},&quot;external-resources&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;wiki&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;dashboard&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;}],&quot;integrations&quot;:{&quot;pagerduty&quot;:&quot;\u003cstring\u003e&quot;},&quot;org&quot;:{&quot;application&quot;:&quot;\u003cstring\u003e&quot;,&quot;team&quot;:&quot;\u003cstring\u003e&quot;},&quot;tags&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;},{&quot;attributes&quot;:{&quot;meta&quot;:{&quot;github-html-url&quot;:&quot;\u003cstring\u003e&quot;,&quot;ingested-schema-version&quot;:&quot;\u003cstring\u003e&quot;,&quot;ingestion-source&quot;:&quot;\u003cstring\u003e&quot;,&quot;last-modified-time&quot;:&quot;\u003cstring\u003e&quot;,&quot;origin&quot;:&quot;\u003cstring\u003e&quot;,&quot;origin-detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;warnings&quot;:[{&quot;instance-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;keyword-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;},{&quot;instance-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;keyword-location&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;}]},&quot;schema&quot;:{&quot;schema-version&quot;:&quot;v1&quot;,&quot;info&quot;:{&quot;dd-service&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;display-name&quot;:&quot;\u003cstring\u003e&quot;,&quot;service-tier&quot;:&quot;\u003cstring\u003e&quot;},&quot;contact&quot;:{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;slack&quot;:&quot;\u003cstring\u003e&quot;},&quot;extensions&quot;:{&quot;laboris_99d&quot;:{},&quot;ad_7d0&quot;:{}},&quot;external-resources&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;repo&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;url&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;}],&quot;integrations&quot;:{&quot;pagerduty&quot;:&quot;\u003cstring\u003e&quot;},&quot;org&quot;:{&quot;application&quot;:&quot;\u003cstring\u003e&quot;,&quot;team&quot;:&quot;\u003cstring\u003e&quot;},&quot;tags&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;}]}