Activity - Runtools.ai

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
  }
}

GET

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
  }
}

GET /v1/activity returns customer-visible activity events for every resource the caller can see — sandboxes, agents, threads, tools, workspaces, devices, and more. Use it for audit views, troubleshooting, resource timelines, and product observability.

Query Parameters

string

One of sandbox, agent, workspace, thread, tool, installable_agent_install, runmesh_device, or code_execution.

string

Resource identifier. When provided with resource_type, access is checked for that resource.

string

Machine-readable event type, such as agent.run.started or tool.call.failed.

string

info, warning, or error.

string

Event-specific state, such as started, completed, failed, or added.

string

Admin-only when different from the current user.

string

Filter by thread.

string

Filter by agent run.

string

Filter by sandbox.

string

Filter by workspace.

string

Filter by Tool Hub slug.

string

Filter by installable-agent install.

string

Filter by code execution.

string

Filter by RunMesh node.

string

ISO timestamp lower bound.

string

ISO timestamp upper bound.

number

default:"50"

Maximum 200.

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:

Path	Description
`/v1/sandboxes/{id}/activity`	Sandbox activity
`/v1/agents/{slug}/activity`	Agent activity
`/v1/threads/{threadId}/activity`	Thread activity
`/v1/workspaces/{id}/activity`	Workspace activity
`/v1/runmesh/devices/{id}/activity`	RunMesh device activity
`/v1/installable-agents/installs/{installId}/activity`	Installable-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.

Billing Models

​Query Parameters

​Resource Activity Shortcuts

Query Parameters

Resource Activity Shortcuts