CoCoCoCoCoCo / docs
← API reference
Mutation / jobs

upsertCapability

Create a capability, or replace an existing one wholesale when input.id is given. Unlike createCapability/updateCapability this does not reject a duplicate code. The capability is written under the caller's tenant. Requires capability:write permission.

Arguments

inputUpsertCapabilityInput!

The capability to create or replace. With input.id the existing capability is overwritten wholesale; without it a new one is created.

Returns UpsertCapabilityPayload!

Explore in a view

Production Floor
View exact SDL
"""
Create a capability, or replace an existing one wholesale when input.id is given. Unlike createCapability/updateCapability this does not reject a duplicate code. The capability is written under the caller's tenant. Requires capability:write permission.
"""
upsertCapability(
  """
  The capability to create or replace. With input.id the existing capability is overwritten wholesale; without it a new one is created.
  """
  input: UpsertCapabilityInput!
): UpsertCapabilityPayload! @topic(names: ["jobs"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.