Skip to content

List tool test runs

View .md
GET

Recent runs of this tool triggered from the test endpoint, newest first. Covers manual tests only: a tool called by an agent during a real conversation is not recorded here.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • senderIdstringrequired
  • toolIdstringrequired

Query parameters

  • limitinteger
    Default20
    Limitsmax 100

Responses

200Recent test runs.
  • itemsobject[]required
    9 properties
    • idstringrequired
    • toolIdstringrequired
    • paramsobject

      The parameters the tool was called with.

    • successbooleanrequired

      Whether the tool returned without error. A tool that answered with a non-2xx status is a failed run, not an error of this endpoint.

    • statusCodeintegernullable

      HTTP status the tool's webhook returned. Absent for tools that do not go over HTTP.

    • responsestringnullable

      The tool's response body, truncated.

    • errorstringnullable

      Why the run failed, when it did.

    • durationMsintegerrequired
    • createdAtstring<date-time>required
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Tool not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject