curl --request GET \
--url https://api.ravion.com/activity-facets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ravion.com/activity-facets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ravion.com/activity-facets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ravion.com/activity-facets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ravion.com/activity-facets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ravion.com/activity-facets")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ravion.com/activity-facets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"categories": [
{
"category": "runs",
"count": 123
}
],
"environments": [
{
"count": 123,
"value": "<string>"
}
],
"events": [
{
"catalogId": "<string>",
"category": "runs",
"count": 123
}
],
"pipelines": [
{
"count": 123,
"value": "<string>"
}
],
"projects": [
{
"count": 123,
"value": "<string>"
}
],
"total": 123
}
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}Count activity by category, event and place
Count your organization’s activity by category, catalog id, project, environment and pipeline, as the Activity page’s sidebar shows it.
curl --request GET \
--url https://api.ravion.com/activity-facets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ravion.com/activity-facets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ravion.com/activity-facets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ravion.com/activity-facets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ravion.com/activity-facets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ravion.com/activity-facets")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ravion.com/activity-facets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"categories": [
{
"category": "runs",
"count": 123
}
],
"environments": [
{
"count": 123,
"value": "<string>"
}
],
"events": [
{
"catalogId": "<string>",
"category": "runs",
"count": 123
}
],
"pipelines": [
{
"count": 123,
"value": "<string>"
}
],
"projects": [
{
"count": 123,
"value": "<string>"
}
],
"total": 123
}
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"action": {
"label": "<string>",
"url": "<string>"
},
"description": "<string>",
"details": [
{
"render": "<string>",
"title": "<string>",
"items": [
"<string>"
],
"object": {}
}
],
"isInternal": true,
"metadata": {},
"requestId": "<string>"
}Query Parameters
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
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$Only entries recorded before this time. Defaults to now. UTC RFC3339 timestamp with a required Z suffix
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$Categories to include. Omitted means every category you may read. Naming access without permission to update the organization is refused with 403.
3Which Activity section an entry belongs to. It also decides who may read the entry: Access and security entries are visible to organization admins only.
runs, changes, access Activity catalog ids to include, exactly as listActivityCatalog returns them. An id outside the activity catalog is refused with 400.
200Activity catalog ids to leave out.
200Identities to include.
50An 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.
^(system|(member|api_key|mcp_client|service_account):[A-Za-z0-9_]+)$Identities to leave out.
50An 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.
^(system|(member|api_key|mcp_client|service_account):[A-Za-z0-9_]+)$Kinds of identity to include.
5The kind of identity that acted. Every credential that can act on Ravion is an identity, not only people.
member, service_account, api_key, mcp_client, system Kinds of identity to leave out.
5The kind of identity that acted. Every credential that can act on Ravion is an identity, not only people.
member, service_account, api_key, mcp_client, system Projects to include.
200Projects to leave out.
200Environments to include.
200Environments to leave out.
200Pipelines to include.
200Pipelines to leave out.
200Module instances to include: entries about the module instance itself, its deployments, and the pipeline runs and steps that act on it.
200Only entries about one kind of resource, for example pipeline_run. Pair it with subjectId to read one resource's history.
Only entries about the resource with this id. Pair it with subjectType.
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.
50Resource names to leave out, compared case-insensitively.
50Outcomes to include.
2Whether the recorded action succeeded. A cancelled or rolled-back outcome counts as succeeded: the action did what was asked.
succeeded, failed Source IP addresses to include, exactly as recorded.
50Source IP addresses to leave out.
50Clients to include.
6The client a request came from, as identified by its User-Agent and by how it authenticated.
dashboard, cli, api, terraform, mcp, slack Clients to leave out.
6The client a request came from, as identified by its User-Agent and by how it authenticated.
dashboard, cli, api, terraform, mcp, slack Request ids to include, as returned in the responses of the requests that caused each entry.
50Only the entries one action caused, including work Ravion finished later on its own.
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.
10Response
The request has succeeded.
Show child attributes
Show child attributes
Was this page helpful?