Skip to main content
POST
Deprecate a contract version

Autorizaciones

Authorization
string
header
requerido

JWT issued by the identity provider. A producer calls with a service credential issued for the tenant it sends facts for; a reader calls with a user token or a service credential. The tenant is always taken from the token, never from the request path, query or body.

Parámetros de ruta

producer
string
requerido

Producer service that owns the fact type.

Ejemplo:

"payments-api"

namespace
string
requerido

Namespace of the fact type.

Ejemplo:

"acme.payments"

type
string
requerido

Fact type name.

Ejemplo:

"payments.payment_confirmed"

schemaVersion
string
requerido

Semantic version of the contract (major.minor.patch).

Ejemplo:

"1.0.0"

Respuesta

The contract version, now DEPRECATED: the transition, or a replay on a version that was already deprecated.

createdAt
string<date-time>
requerido

When this version was registered. RFC 3339, UTC.

hash
string
requerido

Content hash verified at registration (the prefix sha256: plus 64 hex characters); the authoritative integrity value of this version.

namespace
string
requerido

Namespace of the fact type, bound to the producer that registered in it first.

Ejemplo:

"acme.checkout"

producer
string
requerido

Producer service that owns the fact type.

Ejemplo:

"checkout-api"

references
object[] | null
requerido

References facts of this type carry, each with the scope and sensitivity its reference type had at registration.

schema
any
requerido

Payload schema as stored: member order, whitespace and number spelling may differ from what was sent, so check integrity with hash, never by rehashing this.

schemaVersion
string
requerido

Semantic version of this contract (major.minor.patch).

Ejemplo:

"1.0.0"

status
enum<string>
requerido

Lifecycle status: a DEPRECATED version refuses new facts and never returns to ACTIVE. Allowed values: ACTIVE, DEPRECATED.

Opciones disponibles:
ACTIVE,
DEPRECATED
team
string
requerido

Owning team or squad, as registered; informational and audited, never an identity.

Ejemplo:

"checkout-squad"

type
string
requerido

Fact type name, chosen by the producer.

Ejemplo:

"checkout.order_placed"

compatibilityPolicy
enum<string>

How a new version is checked against the earlier versions of its major. Allowed values: TRANSITIVE.

Opciones disponibles:
TRANSITIVE