> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intelligence run tasks

> List, read, and label the intelligence-run records on your storefront.

Intelligence-run records capture how the Merchandising Agent answered each
buyer request. All requests use the storefront base URL with a bearer token:

```
https://api.apostra.com/api/v2/storefront
```

| Task | Method | Path | Purpose |
| - | - | - | - |
| [List](/v2/storefront/intelligence-runs/tasks/list-intelligence-runs) | `GET` | `/intelligence-runs` | Paginated list, newest first |
| [Get](/v2/storefront/intelligence-runs/tasks/get-intelligence-run) | `GET` | `/intelligence-runs/{id}` | Fetch one run in full |
| [Label](/v2/storefront/intelligence-runs/tasks/label-intelligence-run) | `PUT` | `/intelligence-runs/{id}/label` | Attach an evaluator label |

## Related

<CardGroup cols={2}>
  <Card title="Intelligence runs overview" href="/v2/storefront/intelligence-runs/overview" icon="microscope">
    Run record fields and what each captures.
  </Card>

  <Card title="Seller analytics" href="/v2/storefront/analytics" icon="chart-line">
    The aggregate view across many runs.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.