Get latest DPA settings for organization

Fetch latest DPA settings for organization

get

Response

application/json

Response body for retrieving DPA settings

DPASettings

Represents the settings for Data Protection Addendum (DPA) for an organization.

idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

namestring

The optional settings name.

consent_bystring

The optional settings consent by.

consent_statusstringrequired

The consent status for DPA.

Allowed values:APPROVEDREVOKED

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

get/o11y/org-settings/dpa
 
application/json

Control Plane Logs

Control Plane Logs APIs

Search Control Plane Logs

Search logs for a specific control plane with filtering capabilities

post

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[after]string

Request the next page of data, starting with the item after this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

page[before]string

Request the next page of data, starting with the item before this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Body

application/json

Request body for searching control plane logs.

Represents the request payload for searching control plane logs.

startstring(date-time)required

The start time for the log search query. Must be in RFC-3339 format.

endstring(date-time)required

The end time for the log search query. Must be in RFC-3339 format.

node_idarray[string](uuid)unique-items

A list of data plane node IDs to filter logs.

log_levelarray[string]unique-items

The log level for control plane logs.

Allowed values:DEBUGINFOWARNERROR

attributesobject

Key-value pairs to filter logs based on specific attributes.

* Additional properties are NOT allowed.
Show Child Parameters
order_byobject

Specifies the sorting order for the logs in the response.

Show Child Parameters

Response

application/json

Response body for searching control plane logs

ControlPlaneLogSearchResponseSchema

metaobject
Show Child Parameters
logsarray[object]required

Represents a control plane log message

Show Child Parameters
post/control-planes/{controlPlaneId}/o11y/logs/search

Body

{ "start": "2025-04-22T00:00:00Z", "end": "2025-04-22T23:59:59Z", "node_id": [ "d32d905a-ed33-46a3-a093-d8f536af9a8a" ], "log_level": [ "ERROR", "WARN" ], "attributes": { "node_version": { "eq": "3.11.0.2" }, "node_hostname": { "in": [ "dataplane-aea06c00", "148e2409b54038" ] } }, "order_by": { "field": "timestamp", "direction": "desc" } }
 
application/json

Search Distinct Values in Control Plane Logs

Retrieve distinct values for a specified field in control plane logs with optional filtering

post

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

logFieldFilterstringrequired

Field to filter logs by distinct values.

Allowed values:log_levelnode_idnode_version

Example:log_level

Body

application/json

Request body for searching control plane logs.

Represents the request payload for searching control plane logs.

startstring(date-time)required

The start time for the log search query. Must be in RFC-3339 format.

endstring(date-time)required

The end time for the log search query. Must be in RFC-3339 format.

node_idarray[string](uuid)unique-items

A list of data plane node IDs to filter logs.

log_levelarray[string]unique-items

The log level for control plane logs.

Allowed values:DEBUGINFOWARNERROR

attributesobject

Key-value pairs to filter logs based on specific attributes.

* Additional properties are NOT allowed.
Show Child Parameters
order_byobject

Specifies the sorting order for the logs in the response.

Show Child Parameters

Response

application/json

Response containing distinct values for a specific attribute in control plane logs

DistinctValuesResponse

Represents distinct values for a specific attribute

dataarray[string]requiredunique-items

A list of distinct values for the specified attribute

post/control-planes/{controlPlaneId}/o11y/logs/distinct-values/{logFieldFilter}

Body

{ "start": "2025-04-22T00:00:00Z", "end": "2025-04-22T23:59:59Z", "node_id": [ "d32d905a-ed33-46a3-a093-d8f536af9a8a" ], "log_level": [ "ERROR", "WARN" ], "attributes": { "node_version": { "eq": "3.11.0.2" }, "node_hostname": { "in": [ "dataplane-aea06c00", "148e2409b54038" ] } }, "order_by": { "field": "timestamp", "direction": "desc" } }
 
application/json

Cloud Gateway Logs

Cloud Gateway Logs APIs