---
title: "Read canonical feature context"
method: GET
path: "/feature-context"
tags: ["Actions"]
---

# Read canonical feature context

`GET /feature-context`

Return the complete context for one feature in one implementation.

This is the main read endpoint for spec-driven work. It returns the complete list of acceptance criteria, including the requirement definitions, lists of existing references in code, and additional metadata.

Agents should call this before making additional code changes so they work from the same inherited source of truth that reviewers and dashboards use.

## Query parameters

- `product_name` string, required
- `feature_name` string, required
- `implementation_name` string, required
- `include_refs` boolean
- `include_dangling_states` boolean
- `include_deprecated` boolean
- `statuses` string[]

## Response `200`

Feature context

- FeatureContextResponse
  - `data` object, required
    - `acids` object[], required
      - `acid` string, required
      - `deprecated` boolean
      - `note` string
      - `refs` object[]
        - `branch_name` string, required
        - `is_test` boolean, required
        - `path` string, required
        - `repo_uri` string, required
      - `refs_count` integer, required
      - `replaced_by` string[]
      - `requirement` string, required
      - `state` object, required
        - `comment` string
        - `status` string, nullable
        - `updated_at` string
      - `test_refs_count` integer, required
    - `dangling_states` object[]
      - `acid` string, required
      - `state` object, required
        - `comment` string
        - `status` string, nullable
        - `updated_at` string
    - `feature_name` string, required
    - `implementation_id` string, required
    - `implementation_name` string, required
    - `product_name` string, required
    - `refs_source` object, required
      - `branch_names` string[]
      - `implementation_name` string
      - `source_type` 'local' | 'inherited' | 'none', required
    - `spec_source` object, required
      - `branch_names` string[]
      - `implementation_name` string
      - `source_type` 'local' | 'inherited' | 'none', required
    - `states_source` object, required
      - `branch_names` string[]
      - `implementation_name` string
      - `source_type` 'local' | 'inherited' | 'none', required
    - `summary` object, required
      - `status_counts` object, required
      - `total_acids` integer, required
    - `warnings` string[], required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.dev/acai-sh/apis/acai-api.md) · [All operations](https://skmtc.dev/acai-sh/apis/acai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acai-sh/acai-api/revisions/4a78eb58ece6/schema)