API

Accessed REST API

When an actor interacts with Lucid's REST API, including user actions via the Lucid MCP server.

json

{
  "eventType": "api.accessedRestApi",
  "endpointName": string,
  "version": string
}

API Key Generated

When a user generates an API key.

json

{
  "eventType": "api.apiKeyGenerated",
  "tokenId": string,
  "apiKeyName": string,
  "grants": List[string],
  "expiresAt": timestamp | null,
  "generatedBy": number
}

API Key Deleted

When an API key is deleted.

json

{
  "eventType": "api.apiKeyDeleted",
  "tokenId": string,
  "apiKeyName": string,
  "deletedBy": number
}

OAuth2 Token Invalidated

When an OAuth2 token is invalidated.

json

{
  "eventType": "api.oAuth2TokenInvalidated",
  "tokenId": number,
  "tokenType": string,
  "clientId": string,
  "clientName": string,
  "userId": number | null
}

OAuth2 Token Issued

When an OAuth2 token is issued, including when a user connects to the Lucid MCP server.

json

{
  "eventType": "api.oAuth2TokenIssued",
  "tokenId": number,
  "tokenType": "OAuth2Account" | "OAuth2Client" | "OAuth2User",
  "clientId": string,
  "clientName": string,
  "scopes": List[string],
  "expiresAt": timestamp | null,
  "generatedBy": number | null
}

OAuth2 Token Refreshed

When an OAuth2 token is refreshed.

json

{
  "eventType": "api.oAuth2TokenRefreshed",
  "tokenId": number,
  "tokenType": string,
  "clientId": string,
  "clientName": string,
  "newExpiresAt": timestamp,
  "refreshedBy": number | null
}

OAuth2 Token Revoked

When an OAuth2 token is revoked.

json

{
  "eventType": "api.oAuth2TokenRevoked",
  "tokenId": number,
  "tokenType": string,
  "clientId": string,
  "clientName": string,
  "expiresAt": timestamp,
  "userId": number | null
}

Bearer Token Issued

When a bearer token is issued.

json

{
  "eventType": "api.bearerTokenIssued",
  "name": string | null,
  "consumerType": string | null,
  "consumerId": string,
  "tokenId": string
}

Bearer Token Deleted

When a bearer token is deleted.

json

{
  "eventType": "api.bearerTokenDeleted",
  "consumerName": string | null,
  "consumerType": string | null,
  "consumerId": number,
  "tokenId": string
}