Skip to content
Artbucket

Connections: what each agent asked for

GET
/api/v1/insights/connections
curl --request GET \
  --url http://localhost:3000/api/v1/insights/connections \
  --header 'Authorization: Bearer <token>'

Per agent (an API key or OAuth client, by name), over the last 30 days: the MCP tools it called and how many failed, the brand contexts it asked for, the uses it was refused and why, and the files it fetched and searches it made. A tool call keeps its name and outcome, never its arguments.

Scope: write.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

Connections

Media typeapplication/json
object
data
required
object
days
required

How far back it goes

integer
>= -9007199254740991 <= 9007199254740991
clients
required

Busiest first

Array<object>
object
client
required

The agent, by its key’s name

string
events
required

Everything it did, counted

integer
>= -9007199254740991 <= 9007199254740991
tools
required

MCP tools it called, most first

Array<object>
object
name
required
string
calls
required
integer
>= -9007199254740991 <= 9007199254740991
failed
required

Errors and refusals

integer
>= -9007199254740991 <= 9007199254740991
contexts
required

Brand contexts it asked for, in checks and lookups

Array<object>
object
context
required
string
count
required
integer
>= -9007199254740991 <= 9007199254740991
refusals
required
object
total
required
integer
>= -9007199254740991 <= 9007199254740991
reasons
required

A check’s blocking reasons; scope: a tool its key may not run

Array<object>
object
code
required
string
count
required
integer
>= -9007199254740991 <= 9007199254740991
fetches
required
integer
>= -9007199254740991 <= 9007199254740991
searches
required
integer
>= -9007199254740991 <= 9007199254740991
Examplegenerated
{
  "data": {
    "days": 1,
    "clients": [
      {
        "client": "example",
        "events": 1,
        "tools": [
          {
            "name": "example",
            "calls": 1,
            "failed": 1
          }
        ],
        "contexts": [
          {
            "context": "example",
            "count": 1
          }
        ],
        "refusals": {
          "total": 1,
          "reasons": [
            {
              "code": "example",
              "count": 1
            }
          ]
        },
        "fetches": 1,
        "searches": 1
      }
    ]
  }
}

default

Section titled “default”

An error

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
detail
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "detail": "example"
  }
}