OpenPipeline Ingest API - POST Custom SDLC event endpoint

Configures custom endpoints to ingest Software Development Lifecycle (SDLC) events.

The request consumes an application/json payload.

POSTSaaShttps://{your-environment-id}.live.dynatrace.com/platform/ingest/custom/events.sdlc/{endpoint}

Authentication

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

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

Parameters

Parameter
Type
Description
In
Required
endpoint
string

The configuration of the endpoint parameter.

path
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.