Lookup table activity

Request

GET /v1/lookup-tables/{table_id}/activity

Lists what was done to one lookup table this key can read, newest first: the table, its fields, rows, lookups and imports. Each entry is when it happened, the action's name, who acted (a person, an API key with its id, or the system) and, for a key, whether it came through the API or an AI app. What was changed is not returned. occurred_at_from and occurred_at_before narrow it to a time range, actor_type to people, API keys or the system, and api_key_id to one key. Send next_cursor as cursor for the next page.

Requires lookup_tables:read. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: list_lookup_table_activity. Its argument names match the fields below; an HTTP header is passed using its argument name in MCP.

Parameters

Name	Send in	Required	Type or allowed values	Notes
table_id	path	Yes	string
occurred_at_from	query	No	string (date-time)
occurred_at_before	query	No	string (date-time)
actor_type	query	No	"person", "api_key", "system"
api_key_id	query	No	string (uuid)
limit	query	No	integer
cursor	query	No	string

Response

HTTP status	Result
200	The requested result. Asynchronous work returns an operation to poll.

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

Response field	Type	Required in object	Notes
data	array of object	Yes
data[].object	"lookup_table_activity"	Yes
data[].id	string	Yes
data[].occurred_at	string	Yes
data[].action	"lookup.table.created", "lookup.table.renamed", "lookup.table.archived", "lookup.table.deleted", "lookup.table.fill_retried", "lookup.table.fill_dismissed", "lookup.table_exported", "lookup.table_row_limit.set", "lookup.field.created", "lookup.field.updated", "lookup.field.archived", "lookup.row.created", "lookup.row.updated", "lookup.row.deleted", "lookup.definition.enabled", "lookup.definition.retired", "lookup.definition.default_changed", "lookup.import.created", "lookup.import.upload_requested", "lookup.import.uploaded", "lookup.import.preview_requested", "lookup.import.apply_requested", "lookup.import.started", "lookup.import.chunk_applied", "lookup.import.cancel_requested", "lookup.import.applied", "lookup.import.canceled", "lookup.import.failed", "lookup.import.expired", "lookup.app_table.enabled", "lookup.app_table.disabled", "lookup.app_table.rows_written", "lookup.statuses.synced"	Yes
data[].actor	object	Yes
data[].actor.type	"person", "api_key", "system"	Yes
data[].actor.api_key_id	string or null	Yes
data[].via	"api", "mcp" or null	Yes
data[].operation_id	string or null	No
pagination	object	Yes
pagination.next_cursor	string or null	Yes

Errors

HTTP status	Meaning
400	One of: credential_in_url, invalid_parameter, unknown_parameter, invalid_request, invalid_cursor.
401	One of: missing_credential, invalid_credential, credential_expired, credential_revoked.
402	One of: payment_overdue.
403	The current permissions, plan or policy do not allow this request.
404	One of: not_found.
409	The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying.
410	The requested resource or retained recovery data has expired.
413	One of: request_too_large.
422	A field, filter or selection cannot be used for this request.
423	One of: organization_reopening.
428	One of: customer_agreement_required.
429	One of: rate_limited.
503	One of: service_unavailable.

See errors and recovery and safe retries before repeating a write.

The public OpenAPI document lists generally available API families. Alpha operations may not appear in that document; their request and response fields are listed on this page. Use the API Playground to inspect a real response with your connection's access.