Sign in

v68

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0189430445.4 KB
Datasources

Get datasource instance credential status

Returns the current credential status for a datasource instance. Access is limited to callers with the ADMIN scope; the handler enforces this check.

get/rest/api/v1/datasource/{datasourceInstanceId}/credentialstatus

Path parameters

datasourceInstanceIdstring required
Example:o365sharepoint_abc123

The full datasource instance identifier (e.g. o365sharepoint_abc123)

Response

OK

status'VALID' | 'VALID_WITH_WARNINGS' | 'VALIDATING' | 'INVALID' | 'MISSING' required

Lifecycle state of the credentials installed for a datasource instance. Mirrors the internal admin Status enum so the handler can surface the same health signals already tracked today. EXPIRING_SOON is represented as VALID_WITH_WARNINGS (with detail in message); EXPIRED is surfaced as INVALID plus a non-null expiresAt in the past.

lastRotatedAtstring date-time

When the credentials were last rotated. Omitted when not known.

expiresAtstring date-time

When the active credentials expire. Omitted when not known or not applicable to this credential type.

messagestring

Optional human-readable detail about the current credential status.