PUT /api/v1/<type> — create or update a resource. The body is the kubectl-style envelope (apiVersion / kind / metadata / spec); there is no separate create vs. update call. It is idempotent by metadata.id: if the id already exists the resource is updated, otherwise it's created. Omit the id and the server (or the SDK) assigns a fresh ULID.

The call is asynchronous — it returns { requestId, resourceId } immediately. Use the requestId with GET /request/{requestId} to wait for the change to reconcile. SDK method: create_or_update(body) (aliases create / update).

Related pages

Guides

• GET /request/{requestId} endpoint

More in this section

• DELETE /{id}
• GET /{id}
• GET /get-by-labels
• Design ideas

Reference

• Interactive API reference (Swagger)