Audit Logs

Audit logs provide a record of all actions taken in the workspace, including who performed the action, when it was done, and what was changed. Learn more about audit logs here.

List Audit Logs

get

This endpoint retrieves a list of audit logs for the workspace, providing a comprehensive record of actions taken by users, systems, and integrations.

The audit logs can be filtered and sorted using the advanced filter and sort query parameters, which allow for complex filtering based on multiple criteria.

Authorizations

Query parameters

filterstringOptional

A serialized and URL encoded JSON object to define filters on the audit logs. This follows the same pattern as catalog filters, allowing for complex filtering based on multiple criteria.

Example: {"operator":"and","operands":[{"operator":"exact","field":"performer_type","value":"USER"}]}

sortstringOptional

A serialized and URL encoded JSON object to define the sort pattern on the audit logs.

Example: {"field":"updated_at","order":"desc"}

pageintegerOptional

Page number for paginated results (default is 1)

Default: 1

Responses

200

Successfully retrieved audit logs

application/json

401

Unauthorized - Authentication credentials were not provided or are invalid

403

Forbidden - User does not have permission to access audit logs

500

Internal server error

get

GET /api/v1/activity_log/audit_logs/ HTTP/1.1
Host: api.secoda.co
Authorization: Bearer string
Accept: */*

{
  "results": [
    {
      "id": "text",
      "parent_id": "text",
      "activity_type": "text",
      "performer_id": "text",
      "performer_type": "API",
      "performer_metadata": {
        "id": "text",
        "email": "text",
        "first_name": "text",
        "last_name": "text",
        "name": "text"
      },
      "resource_id": "text",
      "resource_type": "text",
      "resource_metadata": {
        "id": "text",
        "title": "text",
        "name": "text",
        "icon": "text",
        "type": "text",
        "integration_id": "text"
      },
      "related_resource_ids": [
        "text"
      ],
      "related_resource_type": "text",
      "event_blocks": [
        {
          "type": "text",
          "style": "normal",
          "value": "text"
        }
      ],
      "logged_at": "2025-07-18T22:13:14.299Z",
      "created_at": "2025-07-18T22:13:14.299Z",
      "updated_at": "2025-07-18T22:13:14.299Z",
      "is_legacy": true,
      "version_history_id": "text",
      "secoda_entity_type": "text"
    }
  ],
  "total_pages": 1,
  "count": 1,
  "meta": {
    "page": 1,
    "previous_page": 1,
    "next_page": 1,
    "count": 1,
    "total_pages": 1
  }
}

List Resource Logs

get

This endpoint retrieves a list of logs for a specific resource, providing a history of changes and actions taken on that resource.

Authorizations

Query parameters

resource_idstringRequired

ID of the resource to retrieve logs for

Example: 550e8400-e29b-41d4-a716-446655440000