Skip to main content

deleteActor

DESTRUCTIVE: permanently deletes the actor identified by uuid and returns a copy of the now-deleted row. OWNER-EXCLUSIVE: only the owner may delete (throws Unauthorized otherwise). Game-plane: requires an app token for the actor’s app (a session token or another app’s token is answered NotFound). uuid is the 32-character ASCII actor id.

deleteActor(
  uuid: String!
  idempotencyKey: String
): Actor!

Arguments​

deleteActor.uuid ● String! non-null scalar​

Actor id to delete: exactly 32 ASCII characters (the UDP-wire actor id), NOT a hyphenated RFC-4122 UUID.

deleteActor.idempotencyKey ● String scalar​

Optional idempotency key. Recommended for retries: replaying with the same key and identical arguments returns the first result instead of re-applying; the same key with different arguments returns IDEMPOTENCY_CONFLICT. Keys expire after 24h.

Type​

Actor object​