List principles
GET/targets/:tid/principles
q matches (case-insensitive substring) against a principle's name or description. sort accepts name, importance, updated_at, and created_at (default, newest first). executions counts referencing executions and is offset-only — combining it with cursor returns 400. category_id restricts to one category; uncategorized restricts to principles with no category (the absence of one, not a category id) — the two are mutually exclusive. tags restricts to principles carrying any of the given tags, but always also keeps untagged principles, mirroring the dashboard's tag filter.
Request
Responses
- 200
- 401
- 404
- 422
Successful Response
Missing or invalid credentials
Resource not found (incl. cross-org ids)
Request validation failed