ATCs

Search ATCs by title and tags

Changed on

Bearer atc:read (or cookie session). Project-scoped full-text search over ATC title + tags, ranked by relevance with a 7-day recency tie-break, optionally narrowed by a module subtree, layer, technique and/or priority (BK-399) — every narrow is ANDed with the others. query and project_id remain REQUIRED: this is a search endpoint, not a list endpoint, so a classification narrow alone is not a valid request. Results are restricted to the caller's active workspace memberships AND to the required project_id; a project outside those memberships returns no rows. Zero matches return an empty items array (never 404).

get/api/v1/atcs/search

Request

  • Base URL: http://localhost:3000
  • URL: http://localhost:3000/api/v1/atcs/search
  • Auth: one of:
    • API key in cookie sb-fmbpikzpkafptqximhxn-auth-token
    • HTTP bearer

Query parameters

querystring required

Free-text query matched against ATC title + tags. Single token is prefix-aware (autocomplete); multiple words use AND semantics.

project_idstring uuid required

Required. Scopes the search to a single project; a project outside the caller's active workspaces returns no rows.

module_idstring uuid

Narrow results to this module and its descendant subtree.

layer'UI' | 'API' | 'Unit'
technique'Equivalence Partitioning' | 'Boundary Value Analysis' | 'State Transition' | 'Decision Table' | 'Pairwise'

BK-399 — narrow to one test-design technique. Exact display label, case-sensitive, not trimmed (URL-encode the spaces, e.g. technique=Decision+Table). Absent means no narrow; there is no sentinel for "not specified", so ATCs with a NULL technique are unreachable through this parameter.

priority'Critical' | 'High' | 'Medium' | 'Low'

BK-399 — narrow to one ATC priority (distinct from Bug severity). Same strictness and same absence semantics as technique.

limitinteger

1..50, default 20.

Response

Ranked matches (possibly empty).

Changes

  • 5e9ef1c7d40cRevision changes
    • info

      added the new optional query request parameter priority

    • info

      added the new optional query request parameter technique

  • 4528999528c6Revision changes
    • warning

      added the new test_outside_plan_project enum value to the / response property for the response status

    • warning

      added the new test_outside_plan_project enum value to the / response property for the response status

    • warning

      added the new test_outside_plan_project enum value to the / response property for the response status