API · Platform · Account
List account agent actions.
Returns the most recent agent actions executed against this org via the MCP layer. Each row records which tool ran, which token kind initiated it, the elapsed wall-clock time, and the outcome bucket (success or error).
This is the operator surface for "what has my agent been doing on my behalf?" — distinct from the per-resource audit chain at /v1/account/audit (cryptographic, append-only, per-resource) and from the per-token rate-limit headers (point-in-time, not historical).
Reads are PII-classified highly_restricted and trigger an audit-on-read entry on every request, regardless of whether any agent_action rows came back.
Last updated
Request
curl -X GET "https://api.mattermode.com/v1/account/agent_actions"fetch("https://api.mattermode.com/v1/account/agent_actions", { method: "GET"})package mainimport ( "fmt" "net/http" "io/ioutil")func main() { url := "https://api.mattermode.com/v1/account/agent_actions" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body))}import requestsheaders = { "Authorization": "Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc", "Matter-Version": "2026-06-10",}resp = requests.get( "https://api.mattermode.com/v1/account/agent_actions", headers=headers,)resp.raise_for_status()print(resp.json())import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.net.http.HttpResponse.BodyHandlers;import java.time.Duration;HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build();HttpRequest.Builder requestBuilder = HttpRequest.newBuilder() .uri(URI.create("https://api.mattermode.com/v1/account/agent_actions")) .GET() .build();try { HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString()); System.out.println("Status code: " + response.statusCode()); System.out.println("Response body: " + response.body());} catch (Exception e) { e.printStackTrace();}using System;using System.Net.Http;using System.Text;var client = new HttpClient();var response = await client.GetAsync("https://api.mattermode.com/v1/account/agent_actions");var responseBody = await response.Content.ReadAsStringAsync();curl --request GET 'https://api.mattermode.com/v1/account/agent_actions' \ --header 'Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc' \ --header 'Matter-Version: 2026-06-10'const response = await fetch("https://api.mattermode.com/v1/account/agent_actions", { method: "GET", headers: { "Authorization": "Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc", "Matter-Version": "2026-06-10", },});if (!response.ok) { throw new Error(`Matter API ${response.status}: ${await response.text()}`);}const data = await response.json();console.log(data);Response
200A page of recent agent actions, newest-first.
application/json{
"object": "list",
"data": [
{
"id": "act_act_xyz",
"object": "agent_action",
"occurred_at": "2026-05-18T09:30:00.000Z",
"tool": "matter_create_entity",
"principal_kind": "rk",
"token_id_prefix": "rk_live_supe",
"mode": "live",
"elapsed_ms": 87,
"outcome": "success",
"status_code": 201,
"error_code": null,
"idempotency_key": "idemp_abc123"
}
],
"has_more": false,
"next_cursor": null
}