terms_not_in_catalogue: A term is not in the catalogue

A term names a metric outside the objective vocabulary or not in this catalogue, a comparison the catalogue does not allow for that metric, or a window outside the entry's bounds. Only objective, measurable metrics with a named signer can be offered. A term with the wrong unit for its metric is malformed and answers terms_offer_invalid instead. Nothing is registered or opened.

The same check runs on a Task Allowance quote's standards when the task is created; nothing is created. On the payee offer route (POST /payee/v1/terms/offers) the 409 body is {"error": "state", "reason": "terms_not_in_catalogue", "detail": "…"}, with no errorDetail.

What to do

On the wire

HTTP 409, error type state_error.

On a stream open (POST /owner/v1/budgets/{id}/streams) and on a task creation the body carries errorDetail only when the request sends Dynamo-Error-Detail: 1. With the header:

{
  "error": "state",
  "reason": "terms_not_in_catalogue",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "terms_not_in_catalogue",
    "message": "…",
    "param": "terms",
    "doc_url": "…/errors/terms_not_in_catalogue.md",
    "fix": "a term names a metric, unit, comparison or window the catalogue does not list; offer only catalogue terms"
  }
}

See all error codes.