(Legacy) Get Audit Logs for an Account | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/accounts/account_id/audit_logs"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

[
  {
    "account_id": "a3f1c9d2-4b7e-4f8a-9d3e-2b5f6c7d8e9f",
    "action": "AssetCreated",
    "actor": {
      "digest_frequency": "weekly",
      "image_32": "https://cdn.frame.io/images/users/1234/image_32.png",
      "image_128": "https://cdn.frame.io/images/users/1234/image_128.png",
      "from_google": true,
      "mfa_enforced_at": "2023-11-01T08:00:00Z",
      "email": "jane.doe@example.com",
      "name": "Jane Doe",
      "image_64": "https://cdn.frame.io/images/users/1234/image_64.png",
      "timezone_value": "America/New_York",
      "account_id": "a3f1c9d2-4b7e-4f8a-9d3e-2b5f6c7d8e9f",
      "updated_at": "2024-04-10T12:00:00Z",
      "image_256": "https://cdn.frame.io/images/users/1234/image_256.png",
      "_type": "User",
      "user_hash": "userhash1234567890",
      "upload_url": "https://upload.frame.io/users/1234",
      "profile_image": "https://cdn.frame.io/images/users/1234/profile_image.png",
      "first_login_at": "2022-05-15T09:00:00Z",
      "joined_via": "google_oauth",
      "id": "b7e9f8a3-c9d2-4b7e-9d3e-2b5f6c7d8e9f",
      "next_digest_date": "2024-04-17T08:00:00Z",
      "last_seen": "2024-04-15T14:30:00Z",
      "inserted_at": "2022-05-15T09:00:00Z",
      "from_adobe": false,
      "avatar_color": "#4A90E2",
      "highest_account_role": "admin",
      "integrations": [
        "slack",
        "dropbox"
      ],
      "roles": {
        "admin": true,
        "id": "role123",
        "sales": false,
        "support": true,
        "service_desk": false
      },
      "user_default_color": "#FF5733"
    },
    "actor_id": "b7e9f8a3-c9d2-4b7e-9d3e-2b5f6c7d8e9f",
    "application_id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7g",
    "inserted_at": "2024-01-15T09:30:00Z",
    "ip_address": "192.168.1.100",
    "item_id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
    "item_type": "asset",
    "request_id": "e1f2a3b4-c5d6-7e8f-9012-3456789abcde",
    "resource": {
      "name": "Project Launch Video",
      "size": 104857600,
      "format": "mp4"
    },
    "team_id": "f1e2d3c4-b5a6-7890-1234-56789abcdef0",
    "updated_at": "2024-01-15T09:30:00Z"
  }
]

Fetch audit logs with some filtering capabilities via query params

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

account_idstringRequired

Query parameters

filter[item_id]stringOptionalformat: "uuid"

Filter by Item ID (Asset ID, Project ID, User ID)

filter[inserted_at][op]enumOptional

Filter by log datetime using logical operators

Allowed values:

filter[inserted_at][value]stringOptionalformat: "date-time"

ISO Datetime

filter[item_type]enumOptional

Filter by Item Type

filter[action]enumOptional

Filter by Action

filter[actor_id]stringOptionalformat: "uuid"

Filter by Actor ID

filter[team_id]stringOptionalformat: "uuid"

Filter by Team ID

filter[ip_address]stringOptional

Filter by IP Address

This supports both IPv4 (1.1.1.1) and IPv6 (2001:db8:3333:4444:5555:6666:7777:8888)

pageintegerOptional

Page number

page_sizeintegerOptional<=10000Defaults to 50

Records per page

Response headers

linkstring

Pagination links

page-numberinteger

Current page of results

per-pageinteger

Number of entries per page

totalinteger

Total entries across all pagess

total-pagesinteger

Number of pages

Response

Audit logs list response

account_idstringformat: "uuid"

actionstring

actorobject

actor_idstringformat: "uuid"

application_idstringformat: "uuid"

inserted_atstringformat: "date-time"

ip_addressstring

item_idstringformat: "uuid"

item_typestring

request_idstringformat: "uuid"

resourceobject

team_idstringformat: "uuid"

updated_atstringformat: "date-time"

Errors

401

Unauthorized Error

404

Not Found Error