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.2", "dd-service"=>"my-service", "application"=>"my-app", "ci-pipeline-fingerprints"=>["j88xdEy0J5lc", "eZ7LMljCk8vo"], "contacts"=>[{"type"=>"slack", "contact"=>"https://teams.microsoft.com/myteam", "name"=>"My team channel"}, {"type"=>"slack", "contact"=>"https://teams.microsoft.com/myteam", "name"=>"My team channel"}], "description"=>"My service description", "extensions"=>{"myorg/extension"=>"extensionValue"}, "integrations"=>{"opsgenie"=>{"service-url"=>"https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000", "region"=>"US"}, "pagerduty"=>{"service-url"=>"https://my-org.pagerduty.com/service-directory/PMyService"}}, "languages"=>["dotnet", "go", "java", "js", "php", "python", "ruby", "c++"], "lifecycle"=>"sandbox", "links"=>[{"name"=>"Runbook", "type"=>"runbook", "url"=>"https://my-runbook", "provider"=>"Github"}, {"name"=>"Runbook", "type"=>"runbook", "url"=>"https://my-runbook", "provider"=>"Github"}], "tags"=>["my:tag", "service:tag"], "team"=>"my-team", "tier"=>"High", "type"=>"web"}

HEADERS

RESPONSES

status: OK

{"data":[{"attributes":{"meta":{"github-html-url":"laborum proident ut exercitation reprehenderit","ingested-schema-version":"velit laboris","ingestion-source":"enim","last-modified-time":"adipisicing do amet ipsum","origin":"do","origin-detail":"veniam","warnings":[{"instance-location":"sed nostrud","keyword-location":"irure consectetur minim","message":"Ut"},{"instance-location":"culpa amet ullamco mollit","keyword-location":"id ea Lorem","message":"sed sit labore veniam ex"}]},"schema":{"schema-version":"v1","info":{"dd-service":"myservice","description":"A shopping cart service","display-name":"My Service","service-tier":"Tier 1"},"contact":{"email":"contact@datadoghq.com","slack":"https://yourcompany.slack.com/archives/channel123"},"extensions":{"myorg/extension":"extensionValue"},"external-resources":[{"name":"Runbook","type":"runbook","url":"https://my-runbook"},{"name":"Runbook","type":"runbook","url":"https://my-runbook"}],"integrations":{"pagerduty":"https://my-org.pagerduty.com/service-directory/PMyService"},"org":{"application":"E-Commerce","team":"my-team"},"tags":["my:tag","service:tag"]}},"id":"Ut proident anim","type":"nostrud commodo"},{"attributes":{"meta":{"github-html-url":"incididunt nostrud sin","ingested-schema-version":"in","ingestion-source":"commodo","last-modified-time":"adipisicing qui e","origin":"adipisicing","origin-detail":"Ut proident","warnings":[{"instance-location":"exercitation ea veniam","keyword-location":"adipisicing dolore amet","message":"adipisicing enim sit ut"},{"instance-location":"dolor Excepteur cillum non","keyword-location":"elit","message":"aute in ea est"}]},"schema":{"schema-version":"v1","info":{"dd-service":"myservice","description":"A shopping cart service","display-name":"My Service","service-tier":"Tier 1"},"contact":{"email":"contact@datadoghq.com","slack":"https://yourcompany.slack.com/archives/channel123"},"extensions":{"myorg/extension":"extensionValue"},"external-resources":[{"name":"Runbook","type":"runbook","url":"https://my-runbook"},{"name":"Runbook","type":"runbook","url":"https://my-runbook"}],"integrations":{"pagerduty":"https://my-org.pagerduty.com/service-directory/PMyService"},"org":{"application":"E-Commerce","team":"my-team"},"tags":["my:tag","service:tag"]}},"id":"dolor quis est ullamco ut","type":"qui l"}]}