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.

POSTSaaShttps://{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

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

Failed. The input is invalid.

404

Failed. Endpoint not found.

413

Failed. Content too large.

429

Failed. Too many requests.

5XX

Server-side error.