Grava Docs

List the provider artifacts recorded for a Run

GET/v1/runs/{runId}/artifacts

Index of bodies recorded at the research provider seam (planning output, cleaned page text, extraction output) so a Run can be explained and replayed. Bodies are never included here; fetch each one from the single-artifact endpoint. Artifacts larger than 64 KiB keep only their hash and size. Artifacts are retained for 30 days; Rows, evidence and history do not depend on them. Runs recorded before artifact capture return an empty list.

AuthorizationBearer <token>

API key shown once at creation and stored as a SHA-256 hash.

In: header

Path Parameters

runId*string
Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/artifacts"
{  "runId": "78c33d18-170c-44d3-a227-b3194f134f73",  "recipe": {    "kind": "research",    "version": 1,    "prompt": "string",    "url": "http://example.com",    "identity": "normalized-name-v1",    "fields": {      "name": "9ffa9185-7453-4fb2-aa6a-3105a6ae83a8",      "evidence": "8c260907-eb60-42e4-a061-22fcfa00a461",      "source": "07b8e003-7027-443f-88b0-24a5eb1cc68b"    },    "plan": {      "title": "string",      "rowMeaning": "string",      "rowIdentity": {        "description": "string",        "kind": "event",        "scopeFields": [          "occurrence"        ]      },      "nameLabel": "string",      "query": "string",      "attributes": [        {          "fieldId": "84922011-b03d-4966-bc95-c5b49bc2e342",          "label": "string",          "description": "string"        }      ]    }  },  "truncated": true,  "artifacts": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "attemptId": "ff88f33b-bb8d-4c28-947a-07ff3d628b10",      "stepId": "50e29fb7-490e-4a88-b2f4-2fde4d70423d",      "kind": "plan.output",      "sourceUrl": "http://example.com",      "sha256": "stringstringstringstringstringstringstringstringstringstringstri",      "bytes": 0,      "truncated": true,      "createdAt": "2019-08-24T14:15:22Z",      "body": null    }  ]}