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.
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.
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.
{"operator":"and","operands":[{"operator":"exact","field":"performer_type","value":"USER"}]}A serialized and URL encoded JSON object to define the sort pattern on the audit logs.
{"field":"updated_at","order":"desc"}Page number for paginated results (default is 1)
1Successfully retrieved audit logs
Unauthorized - Authentication credentials were not provided or are invalid
Forbidden - User does not have permission to access audit logs
Internal server error
GET /api/v1/activity_log/audit_logs/ HTTP/1.1
Host: api.secoda.co
Authorization: Bearer YOUR_SECRET_TOKEN
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-11-05T14:09:34.917Z",
"created_at": "2025-11-05T14:09:34.917Z",
"updated_at": "2025-11-05T14:09:34.917Z",
"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
}
}This endpoint retrieves a list of logs for a specific resource, providing a history of changes and actions taken on that resource.
ID of the resource to retrieve logs for
550e8400-e29b-41d4-a716-446655440000Page number for paginated results (default is 1)
1Successfully retrieved resource logs
Unauthorized - Authentication credentials were not provided or are invalid
Forbidden - User does not have permission to access resource logs
Internal server error
GET /api/v1/activity_log/resource_logs/?resource_id=text HTTP/1.1
Host: api.secoda.co
Authorization: Bearer YOUR_SECRET_TOKEN
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-11-05T14:09:34.917Z",
"created_at": "2025-11-05T14:09:34.917Z",
"updated_at": "2025-11-05T14:09:34.917Z",
"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
}
}Last updated
Was this helpful?