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
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-11T19:38:34.738Z",
      "created_at": "2025-07-11T19:38:34.738Z",
      "updated_at": "2025-07-11T19:38:34.738Z",
      "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
pageintegerOptional

Page number for paginated results (default is 1)

Default: 1
Responses
200
Successfully retrieved resource logs
application/json
get
GET /api/v1/activity_log/resource_logs/ HTTP/1.1
Host: api.secoda.co
Authorization: Bearer string
Accept: */*
{
  "non_versioned_logs": [
    {
      "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-11T19:38:34.738Z",
      "created_at": "2025-07-11T19:38:34.738Z",
      "updated_at": "2025-07-11T19:38:34.738Z",
      "is_legacy": true,
      "version_history_id": "text",
      "secoda_entity_type": "text"
    }
  ],
  "version_histories": [
    {}
  ],
  "total_pages": 1,
  "count": 1,
  "meta": {
    "page": 1,
    "previous_page": 1,
    "next_page": 1,
    "count": 1,
    "total_pages": 1
  }
}

Was this helpful?