tag-definitions

Create Tag Definition Endpoint

Create a new tag definition for the org.

is_system is intentionally not settable from the API — system definitions are reserved for future Verifa-shipped tags.

post/api/v1/tag-definitions

Request

  • Base URL: https://api.withverifa.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.withverifa.com/api/v1/tag-definitions
  • Auth: none declared

Request body

namestring required

Tag string as it appears on identities (e.g. 'Suspicious').

descriptionstring nullable

Optional reviewer-facing tooltip text.

color'blue' | 'gray' | 'green' | 'amber' | 'red' | 'purple' | 'pink'

Palette token; the dashboard maps each token to a Tailwind class pair.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.