OpenPipeline Ingest API - POST Built-in SDLC events

Ingests Software Development Lifecycle (SDLC) events from built-in endpoints.

The request consumes an application/json payload.

POST SaaS https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/events.sdlc

Authentication

To execute this request, you need an access token with openpipeline.events_sdlc scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
body	Events	The JSON body of the request. Contains the events for ingest.	body	required

Request body objects

The `Events` object

The events to be ingested.

Element	Type	Description	Required
<*>	object[]	List of events that will get ingested.	optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

[
  {
    "event.kind": "SDLC_EVENT",
    "event.provider": "jenkins-maven",
    "event.category": "task",
    "event.type": "build",
    "event.status": "started",
    "start_time": "1649822520123123123",
    "cicd.pipeline.id": "9741",
    "cicd.pipeline.run.id": "654131",
    "task.id": "4711",
    "task.name": "Build OneAgent",
    "task.outcome": "Success",
    "artifact.id": "oneagent",
    "artifact.name": "oneagent_v1.232.1",
    "artifact.version": "1.232.1"
  },
  {
    "event.kind": "SDLC_EVENT",
    "event.provider": "jenkins-maven",
    "event.category": "task",
    "event.type": "build",
    "event.status": "finished",
    "end_time": "1649822520123123165",
    "cicd.pipeline.id": "9741",
    "cicd.pipeline.run.id": "654131",
    "task.id": "4711",
    "task.name": "Build OneAgent",
    "task.outcome": "Success",
    "artifact.id": "oneagent",
    "artifact.name": "oneagent_v1.232.1",
    "artifact.version": "1.232.1"
  }
]

Response

Response codes

Code	Type	Description
202	-	Accepted. Response doesn't have a body.
400	ErrorResponseEnvelope	Failed. The input is invalid.
404	ErrorResponseEnvelope	Failed. Endpoint not found.
413	ErrorResponseEnvelope	Failed. Content too large.
429	ErrorResponseEnvelope	Failed. Too many requests.
5XX	ErrorResponseEnvelope	Server-side error.