Upsert a Kong entity
kong_upsertCreate or replace a Kong entity by its ID or name. Adds the entity if absent or fully overwrites it if present.
Instructions
Create or replace an entity at a known id/name (PUT //). Creates it if absent, fully replaces it if present.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The id (UUID) or unique name/slug to upsert at. | |
| data | Yes | The full entity object (JSON). | |
| entity | Yes | The Admin API collection path. Plain entity name (e.g. 'services', 'routes', 'consumers', 'plugins', 'upstreams', 'certificates') or a nested collection path (e.g. 'upstreams/my-upstream/targets', 'services/my-service/routes', 'consumers/bob/key-auth'). Common values: services, routes, consumers, consumer_groups, plugins, upstreams, certificates, ca_certificates, snis, vaults, keys, key-sets, workspaces, acls, tags, upstreams/<upstream>/targets, services/<service>/routes, services/<service>/plugins, routes/<route>/plugins, consumers/<consumer>/plugins, consumers/<consumer>/key-auth, consumers/<consumer>/basic-auth, consumers/<consumer>/jwt, consumers/<consumer>/hmac-auth, consumers/<consumer>/acls, rbac/roles, rbac/users, admins, groups, event-hooks, developers. | |
| workspace | No | EE workspace to scope this request to. Overrides the configured default workspace. Leave empty for OSS or the 'default' workspace. |