Query Step History
Query Parameters
| Parameter | Type | Description |
|---|---|---|
threadId | String! | Thread ID (required) |
stepName | String! | Step name (required) |
idempotencyKey | String | Filter by idempotency key |
limit | Int | Max results (default: 100, max: 1000) |
offset | Int | Pagination offset |
startAt | String | ISO timestamp - history after |
endAt | String | ISO timestamp - history before |
activityType | String | Filter by activity type |
actor | String | Filter by actor ID |
Step Fields
| Field | Type | Description |
|---|---|---|
threadId | String! | Thread ID |
stepName | String! | Step name |
idempotencyKey | String! | Unique step identifier |
status | String! | Current status |
retryCount | Int! | Number of retry attempts |
firstSeenAt | String! | First execution timestamp |
lastUpdatedAt | String! | Last update timestamp |
latestStepID | String! | Latest step ID |
previousStep | String | Previous step name |
actor | String | Actor who executed step |
actorService | String | Service that executed step |
latestContext | String | Latest context data (JSON) |
hash | String | Cryptographic hash |
prevHash | String | Previous step hash |
verified | Boolean | Hash chain verification status |
History Fields
| Field | Type | Description |
|---|---|---|
attempt | Int! | Attempt number |
timestamp | String! | Execution timestamp |
status | String! | Step status |
context | String! | Context data (JSON) |
duration | Int! | Execution duration (ms) |
startedAt | String | Start timestamp |
finishedAt | String | Finish timestamp |
error | String | Error message (if failed) |
actor | String! | Actor ID |
actorService | String! | Service name |
hash | String | Cryptographic hash |
prevHash | String | Previous hash |
Sub-step Fields
| Field | Type | Description |
|---|---|---|
id | ID! | Unique sub-step ID |
name | String! | Sub-step name |
status | String! | Sub-step status |
payload | JSON | Sub-step data |
recordedAt | String! | Recording timestamp |