← API reference
Mutation / admin

upsertUser

Create or update a service account. Only BOT accounts are writable through the API — HUMAN users are provisioned by Control and are read-only here. Requires user:write permission.

Arguments

User data

Returns UpsertUserPayload!

Explore in a view

Administration and IAM
View exact SDL
"""
Create or update a service account. Only BOT accounts are writable through the API — HUMAN users are provisioned by Control and are read-only here. Requires user:write permission.
"""
upsertUser(
  """User data"""
  input: UpsertUserInput!
): UpsertUserPayload! @topic(names: ["admin"])

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