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 and/or layer. 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'
limitinteger

1..50, default 20.

Response

Ranked matches (possibly empty).

Changes

  • e0e3da62d1c7Revision changes
    • warning

      deleted the query request parameter priority

    • warning

      deleted the query request parameter technique

  • 3b5f447e68fcRevision changes
    • info

      added the new optional query request parameter priority

    • info

      added the new optional query request parameter technique