Skip to main content
PUT
Upsert a plugin declaration

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

slug
string
requerido

Plugin slug that owns the declaration being upserted.

Ejemplo:

"plugin-fees"

Cuerpo

application/json

Declaration manifest to upsert for the slug.

levels
object[] | null

Scope-only form of the permissions' levels: one entry per permission that declares a level, sent when the permission section is not. Forwarded with the scope catalog. Not accepted next to permissions, which carry their level themselves; alone it is not a section, since it would replace the catalog's dimensions and opt-in with nothing.

m2m
object

Bilateral machine-to-machine contract: which targets this plugin calls and whether it is callable.

partners
boolean

Opts the product in to partner credentials: a partner can be granted this product only when it is true. Forwarded with the scope catalog; a body carrying only this member is a scope-only body. Replaces the opt-in whenever the catalog is replaced.

Ejemplo:

true

permissions
object[] | null

Permissions declared by the plugin; one entry per (resource, action).

roles
object[] | null

Roles declared by the plugin. Names may use '/' for hierarchy but must not repeat the service prefix (it is added automatically).

scope
object

Dimensions the product's routes address instances by — the WHERE a partner's scope lines name. Replaces the product's catalog when present; leaves it untouched when absent. Accepted in single- and multi-tenant deployments.

service
string

Service that owns this declaration; matches the caller token (the plugin- prefix is kept).

Ejemplo:

"plugin-fees"

version
integer<int64>

Advisory manifest version. Must be a positive integer. Excluded from the canonical content hash.

Ejemplo:

3

Respuesta

OK

slug
string
requerido

Slug of the declaration that was upserted.

Ejemplo:

"plugin-fees"

status
string
requerido

Outcome of the upsert operation.

Ejemplo:

"accepted"