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

Request

  • Base URL: https://instance-name-be.glean.com
  • URL: https://instance-name-be.glean.com/rest/api/v1/datasource/{datasourceInstanceId}/credentialstatus
  • Auth: APIToken (a scheme the document does not define)

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.

Changes

No recorded changes to this operation across all 139 revisions of this API.