---
title: "Preview the native decision surfaces"
method: GET
path: "/api/v2/decision-surfaces"
tags: ["Workspace reads"]
---

# Preview the native decision surfaces

`GET /api/v2/decision-surfaces`

## Request

- Base URL: `https://www.hireeli.io`
- URL: `https://www.hireeli.io/api/v2/decision-surfaces`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the exact approved headline, answer, proof and action available to the browser runtime for each intent. This read never activates treatment or expands execution authority.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Tenant-pinned decision surface catalog.

- DecisionSurfaceCatalogResponse
  - `data` object, required
    - `version` 'decision-surface-v1', required
    - `workspaceId` string, uuid, required
    - `available` boolean, required
    - `surfaces` object[], required
      - `version` 'decision-surface-v1', required
      - `key` string, required
      - `intent` string, required
      - `paths` string[], required
      - `slots` object, required
      - `evidence` object, required
      - `constraints` object, required
    - `blockers` string[], required
    - `truth` object, required

## Other responses

- `401`: Credential missing, invalid, expired or revoked.
- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `429`: Request or durable protocol cap reached.
- `503`: A required security, billing, cap, audit, evidence or storage check is unavailable. Writes fail closed.

---

[API](https://skmtc.dev/hireeli/apis/eli-api.md) · [All operations](https://skmtc.dev/hireeli/apis/eli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hireeli/apis/eli-api/revisions/3272729fecd2?raw)