Get audit log entries for an Account | Frame.io API Documentation

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

[
  {
    "anonymous_user_id": null,
    "client": null,
    "event_type": "asset_created",
    "event_details": {
      "account_id": "6bdcb4d9-9a2e-4548-a765-ae6b27a6c024",
      "ext": ".png",
      "filesize": 170144,
      "filetype": "image/png",
      "index": -17,
      "name": "Sample asset.png",
      "parent_id": "ba6cd478-5ca3-4c1a-2186-82cdaecb3e6c",
      "private": false,
      "project_id": "e9794c94-16a4-4e33-b4e6-cdd9757d0e24",
      "sm_refresh_at": "2024-06-28T21:42:54Z",
      "uploaded_at": "2024-06-28T21:42:54.437202Z"
    },
    "id": 1944044771,
    "inserted_at": "2024-06-28T21:42:54.516273Z",
    "ip_address": "255.255.255.255",
    "project_id": "j2794c94-16a4-4e33-b4e6-cdd9757d0e24",
    "resource_id": "92je2963-24ae-4cd1-be13-19a93c92eb6e",
    "resource_type": "asset",
    "team_id": "5j4d6420-fa8d-4e85-af05-0f26785c54f5",
    "source": "unknown",
    "user_id": "b72b57e0-79f2-4bc7-9b70-99fbc175175c",
    "updated_at": "2024-06-28T21:42:54.516273Z"
  }
]

Fetch audit logs with some filtering capabilities via query params

認証

AuthorizationBearer

Bearer <token>形式のBearer認証。tokenは認証トークンです。

パスパラメータ

account_idstring必須

クエリパラメータ

filters[start_date]stringオプション形式: "date"

Start ISO Date

filters[end_date]stringオプション形式: "date"

End ISO Date

filters[resource_type]enumオプション

Filter by Resource Type

filters[event_type]enumオプション

Filter by Type of Activity

filters[team_id]stringオプション形式: "uuid"

Filter by Team ID

filters[project_id]stringオプション形式: "uuid"

Filter by Project ID

filters[resource_id]stringオプション形式: "uuid"

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

filters[user_id]stringオプション形式: "uuid"

Filter by User ID

filters[ip_address]stringオプション

Filter by IP Address

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

pageintegerオプションデフォルト値 1

Page number

page_sizeintegerオプション<=200デフォルト値 50

Records per page

レスポンスヘッダー

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

レスポンス

Succesful Event logs response

account_idstring or null形式: "uuid"

anonymous_user_idstring or null形式: "uuid"

clientstring or null

The API client the audit event was triggered by. This will not always be populated.

When the API call that produced an event was made via an OAuth app it will look like: oauth_app/:uuid, and if it was made via a developer token it will look like: user_token/:uuid, with the UUID being the User ID the token belongs to

Here are some examples:

user_token/57823879-e541-49b0-b902-c43794c4400c
oauth_app/80ccf0bb-ae91-49c4-8aec-8f6238c14947
web/2024-06-10-18-15
pipeline-media-warden/cbd0061f6f190489e8af3137b8707b33f498f53f
null

event_typeenum

event_detailsobject

The details for the event. This varies quite a bit from one type of event to another but there are some examples in the example responses.

iddouble

Unique identifier

inserted_atstring形式: "date-time"

ip_addressstring or null

The IP address associated with this event

project_idstring or null形式: "uuid"

The Project ID that this action occured in

resource_idstring形式: "uuid"

The ID of the referenced resource

resource_typeenum

The type of the referenced resource

team_idstring or null形式: "uuid"

Team ID

sourceenum

The Source of the action that produced a given audit log entry

許可された値:

user_idstring or null形式: "uuid"

User ID

updated_atstring形式: "date-time"

エラー

401

Unauthorized Error

404

Not Found Error