Skip to main content

Documentation Index

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

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

The execution.getExecutionLogs procedure returns the history of past execution runs for a single blueprint, most recent first. Each log record includes rich metadata about how nodes ran: tokens consumed, which AI providers were used, whether external data sources or MCP servers were contacted, and a summary of any errors. Use this data for auditing, debugging, and billing analysis.

​
Request

Procedure type: query (HTTP GET) Endpoint: 
GET https://api.iblueprint.ai/api/trpc/execution.getExecutionLogs

​
Parameters

​
input
object
required
A URL-encoded JSON object with a json key containing the parameters below.
​
json.blueprintId
string
required
UUID of the blueprint whose logs you want to retrieve.
​
json.limit
number
Maximum number of log records to return. Defaults to 20.
​
json.offset
number
Number of records to skip before returning results, for pagination. Defaults to 0.

​
Response

​
logs
array
Array of execution log records, ordered by createdAt descending.
​
total
number
Number of records returned in this response (not the total across all pages).

​
Example

curl -G "https://api.iblueprint.ai/api/trpc/execution.getExecutionLogs" \
  --data-urlencode 'input={"json":{"blueprintId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","limit":10,"offset":0}}' \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Sample response

{
  "result": {
    "data": {
      "json": {
        "logs": [
          {
            "id": "log-uuid-1",
            "blueprintId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "status": "completed",
            "startTime": "2024-12-01T10:00:00Z",
            "endTime": "2024-12-01T10:00:12Z",
            "totalSteps": 4,
            "completedSteps": 4,
            "failedSteps": 0,
            "progress": 100,
            "totalTokensUsed": 1842,
            "usedMcpServers": false,
            "aiProvidersUsedCount": 1,
            "hasErrors": false,
            "inputVariables": { "email_body": "Hi team..." },
            "outputSummary": { "summary": "..." }
          }
        ],
        "total": 1
      }
    }
  }
}

​
Cross-blueprint logs

To fetch logs across all blueprints for your account (or organization), use execution.listRecentExecutions instead. It accepts limit, offset, and an optional organizationId filter, and returns the same log record shape. 
curl -G "https://api.iblueprint.ai/api/trpc/execution.listRecentExecutions" \
  --data-urlencode 'input={"json":{"limit":50,"offset":0}}' \
  -H "Authorization: Bearer YOUR_API_KEY"