Audit API

Get a list of audit events for an account.

POST https://cloud.cdata.com/api/log/audit/list

Audit API

cURL

curl --request POST \
  --url https://cloud.cdata.com/api/log/audit/list

200

{
  "events": [
    {
      "eventType": 1003,
      "timestamp": "2025-08-18T17:07:07.3673862Z",
      "targetId": "aaa96669-74c8-480f-a8c1-7956979cbee9",
      "targetName": "PostgreSQL1",
      "targetType": 1,
      "userId": "6b8d5c25-cdc1-4b0c-b9f1-5b26647a8240",
      "userName": "User1",
      "userType": 0
    },
    {
      "eventType": 1107,
      "timestamp": "2025-08-13T21:20:08.4380865Z",
      "relatedId": "4780a367-2ba0-4b73-b086-b0d964323032",
      "relatedName": "Mcp",
      "relatedType": 4,
      "targetId": "a41dd9b5-1ed6-54d9-b5e5-2754e4a29deb",
      "targetName": "[e-mail]",
      "targetType": 2,
      "userId": "a41dd9b5-1ed6-54d9-b5e5-2754e4a29deb",
      "userName": "User2",
      "userType": 0
    }
  ]
}

Query String Parameters

startTime · string

Timestamp in UTC (ISO 8601 format). Format: date-time

Example: "2025-08-18T00:00:00Z"

endTime · string

Timestamp in UTC (ISO 8601 format).

Format: date-time

Example: "2025-08-18T23:59:59Z"

Headers

Authorization · string · required

Bearer token for authentication.

Format: Bearer

Content-Type · string · required

Defaults to application/json.

Responses

200

Success

Show Response body

events · array of objects · required

eventType · integer · required

The audit event type, such as user login, user PAT created, or permission created.

timestamp · string · required

The timestamp of the event.

relatedId · string · required

The related resource Id, if applicable.

relatedName · string · required

The related resource name, if applicable

relatedType · integer · required

The related resource type, if applicable.

targetId · string · required

The Id of the event, such as the Query Id.

targetName · string · required

The target resource name, such a user’s email or a connection name.

targetType · integer · required

The target type, such as query or connection change.

userId · string

The user’s Id.

userName · string

The user’s name.

userType · integer

The user type.

200

{
  "events": [
    {
      "eventType": 1003,
      "timestamp": "2025-08-18T17:07:07.3673862Z",
      "targetId": "aaa96669-74c8-480f-a8c1-7956979cbee9",
      "targetName": "PostgreSQL1",
      "targetType": 1,
      "userId": "6b8d5c25-cdc1-4b0c-b9f1-5b26647a8240",
      "userName": "User1",
      "userType": 0
    },
    {
      "eventType": 1107,
      "timestamp": "2025-08-13T21:20:08.4380865Z",
      "relatedId": "4780a367-2ba0-4b73-b086-b0d964323032",
      "relatedName": "Mcp",
      "relatedType": 4,
      "targetId": "a41dd9b5-1ed6-54d9-b5e5-2754e4a29deb",
      "targetName": "[e-mail]",
      "targetType": 2,
      "userId": "a41dd9b5-1ed6-54d9-b5e5-2754e4a29deb",
      "userName": "User2",
      "userType": 0
    }
  ]
}