Skip to main content
GET
/
v1
/
activity
curl "https://api.runtools.ai/v1/activity?resource_type=thread&resource_id=thr_abc123&limit=25" \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

{
  "data": {
    "events": [
      {
        "id": "act_abc123",
        "resourceType": "thread",
        "resourceId": "thr_abc123",
        "eventType": "agent.run.completed",
        "severity": "info",
        "status": "completed",
        "title": "Agent run completed",
        "summary": "Agent run completed",
        "threadId": "thr_abc123",
        "agentRunId": "run_abc123",
        "occurredAt": "2026-05-10T12:00:00.000Z"
      }
    ]
  },
  "meta": {
    "hasMore": false,
    "nextCursor": null
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.runtools.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

GET /v1/activity returns customer-visible activity events for resources the caller can access. It is useful for audit views, troubleshooting, resource timelines, and product observability.

​
Query Parameters

​
resource_type
string
One of sandbox, agent, workspace, thread, tool, installable_agent_install, runmesh_device, or code_execution.
​
resource_id
string
Resource identifier. When provided with resource_type, access is checked for that resource.
​
event_type
string
Machine-readable event type, such as agent.run.started or tool.call.failed.
​
severity
string
info, warning, or error.
​
status
string
Event-specific state, such as started, completed, failed, or added.
​
actor_user_id
string
Admin-only when different from the current user.
​
thread_id
string
Filter by thread.
​
agent_run_id
string
Filter by agent run.
​
sandbox_id
string
Filter by sandbox.
​
workspace_id
string
Filter by workspace.
​
tool_slug
string
Filter by Tool Hub slug.
​
installable_agent_install_id
string
Filter by installable-agent install.
​
code_execution_id
string
Filter by code execution.
​
runmesh_node_id
string
Filter by RunMesh node.
​
since
string
ISO timestamp lower bound.
​
until
string
ISO timestamp upper bound.
​
limit
number
default:"50"
Maximum 200.
​
cursor
string
Pagination cursor from meta.nextCursor.
curl "https://api.runtools.ai/v1/activity?resource_type=thread&resource_id=thr_abc123&limit=25" \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

{
  "data": {
    "events": [
      {
        "id": "act_abc123",
        "resourceType": "thread",
        "resourceId": "thr_abc123",
        "eventType": "agent.run.completed",
        "severity": "info",
        "status": "completed",
        "title": "Agent run completed",
        "summary": "Agent run completed",
        "threadId": "thr_abc123",
        "agentRunId": "run_abc123",
        "occurredAt": "2026-05-10T12:00:00.000Z"
      }
    ]
  },
  "meta": {
    "hasMore": false,
    "nextCursor": null
  }
}

​
Resource Activity Shortcuts

Several resources expose activity shortcuts that apply the right authorization and filters:
PathDescription
/v1/sandboxes/{id}/activitySandbox activity
/v1/agents/{slug}/activityAgent activity
/v1/threads/{threadId}/activityThread activity
/v1/workspaces/{id}/activityWorkspace activity
/v1/runmesh/devices/{id}/activityRunMesh device activity
/v1/installable-agents/installs/{installId}/activityInstallable-agent install activity
Activity is scoped to the current organization. Non-admin members see their own actor activity unless the request is authorized by resource access.