API version
API reference / Validate a konnect personal access token
Validate a konnect personal access token
POST/connections/openmeter/validate
Probe a token against one Konnect region without saving a connection. Succeeds only when Metering & Billing returns at least one customer.
Authorization
Headers
Api-Versiondate
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Organization-Idstring
Target organization id (Organization-Id selector).
Connection-Idstring
Target connection id; resolves to its organization.
Entity-Idstring
Platform entity id; resolves to a connection's organization.
Entity-Sourcestring
Optional source to disambiguate an Entity-Id.
Body
apiKeystringRequired
Kong Konnect personal access token to probe.
regionstringRequired
Konnect region: us, eu, au, me, or in.
Response
entitiesOpenMeterValidateEntity[]
The Konnect organization available under this token and region.
200
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request failed validation.
cURL
POST /connections/openmeter/validate
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"apiKey": "********",
"region": "region"
}
Response
{
"entities": [
{
"entityId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"entityName": "Acme Corp"
}
]
}