Skip to main content
GET
Export activity

Query Parameters

occurredAfter
string<date-time>
required

Only entries recorded at or after this time. Required: every Activity read is bounded in time, and it may be at most as far back as Activity is kept, 60 days by default. UTC RFC3339 timestamp with a required Z suffix

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$
occurredBefore
string<date-time> | null

Only entries recorded before this time. Defaults to now. UTC RFC3339 timestamp with a required Z suffix

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$
category
enum<string>[] | null

Categories to include. Omitted means every category you may read. Naming access without permission to update the organization is refused with 403.

Maximum array length: 3

Which Activity section an entry belongs to. It also decides who may read the entry: Access and security entries are visible to organization admins only.

Available options:
runs,
changes,
access
event
string[] | null

Activity catalog ids to include, exactly as listActivityCatalog returns them. An id outside the activity catalog is refused with 400.

Maximum array length: 200
excludeEvent
string[] | null

Activity catalog ids to leave out.

Maximum array length: 200
identity
string[] | null

Identities to include.

Maximum array length: 50

An identity, as <kind>:<id>: member:mem_…, api_key:apikey_…, mcp_client:mem_… (an MCP client acting for that member), service_account:svcact_…, or system for Ravion itself.

Pattern: ^(system|(member|api_key|mcp_client|service_account):[A-Za-z0-9_]+)$
excludeIdentity
string[] | null

Identities to leave out.

Maximum array length: 50

An identity, as <kind>:<id>: member:mem_…, api_key:apikey_…, mcp_client:mem_… (an MCP client acting for that member), service_account:svcact_…, or system for Ravion itself.

Pattern: ^(system|(member|api_key|mcp_client|service_account):[A-Za-z0-9_]+)$
identityType
enum<string>[] | null

Kinds of identity to include.

Maximum array length: 5

The kind of identity that acted. Every credential that can act on Ravion is an identity, not only people.

Available options:
member,
service_account,
api_key,
mcp_client,
system
excludeIdentityType
enum<string>[] | null

Kinds of identity to leave out.

Maximum array length: 5

The kind of identity that acted. Every credential that can act on Ravion is an identity, not only people.

Available options:
member,
service_account,
api_key,
mcp_client,
system
projectId
string[] | null

Projects to include.

Maximum array length: 200
excludeProjectId
string[] | null

Projects to leave out.

Maximum array length: 200
environmentId
string[] | null

Environments to include.

Maximum array length: 200
excludeEnvironmentId
string[] | null

Environments to leave out.

Maximum array length: 200
pipelineId
string[] | null

Pipelines to include.

Maximum array length: 200
excludePipelineId
string[] | null

Pipelines to leave out.

Maximum array length: 200
moduleInstanceId
string[] | null

Module instances to include: entries about the module instance itself, its deployments, and the pipeline runs and steps that act on it.

Maximum array length: 200
subjectType
string | null

Only entries about one kind of resource, for example pipeline_run. Pair it with subjectId to read one resource's history.

subjectId
string | null

Only entries about the resource with this id. Pair it with subjectType.

resourceName
string[] | null

Resource names to include, as they were when each entry was recorded, compared case-insensitively. Entries keep the name a resource had, so a renamed or deleted resource is still found by its old name.

Maximum array length: 50
excludeResourceName
string[] | null

Resource names to leave out, compared case-insensitively.

Maximum array length: 50
status
enum<string>[] | null

Outcomes to include.

Maximum array length: 2

Whether the recorded action succeeded. A cancelled or rolled-back outcome counts as succeeded: the action did what was asked.

Available options:
succeeded,
failed
ip
string[] | null

Source IP addresses to include, exactly as recorded.

Maximum array length: 50
excludeIp
string[] | null

Source IP addresses to leave out.

Maximum array length: 50
client
enum<string>[] | null

Clients to include.

Maximum array length: 6

The client a request came from, as identified by its User-Agent and by how it authenticated.

Available options:
dashboard,
cli,
api,
terraform,
mcp,
slack
excludeClient
enum<string>[] | null

Clients to leave out.

Maximum array length: 6

The client a request came from, as identified by its User-Agent and by how it authenticated.

Available options:
dashboard,
cli,
api,
terraform,
mcp,
slack
requestId
string[] | null

Request ids to include, as returned in the responses of the requests that caused each entry.

Maximum array length: 50
correlationId
string | null

Only the entries one action caused, including work Ravion finished later on its own.

q
string[] | null

Free-text words, compared case-insensitively. An entry matches when every word appears in who acted, its catalog id, the resource name, the project, environment or pipeline name, or the source IP address.

Maximum array length: 10
format
enum<string>
required

The file format.

Available options:
csv,
jsonl

Response

The exported activity file: CSV, or JSON Lines with one entry per line in the shape getActivity returns.

The response is of type file.