Skip to main content

actorsConnection

Relay-style cursor-paginated version of actors: lists actors owned by the authenticated user, optionally narrowed by filter (appId, avatarId, uuid, chunk). Page forward with first (default 50, max 200) and after (an opaque cursor from a previous page’s pageInfo.endCursor); totalCount is the full number of matching actors. Requires a valid game token; only the caller’s own actors are returned (full state included).

actorsConnection(
  first: Int
  after: String
  filter: ActorFilterInput
): ActorsConnection!

Arguments​

actorsConnection.first ● Int scalar​

Return the first N edges after after. Default 50; clamped to 1..200.

actorsConnection.after ● String scalar​

Opaque cursor: return edges after this one. Pass a previous page's pageInfo.endCursor. Omit for the first page.

actorsConnection.filter ● ActorFilterInput input​

Optional filters; all provided fields are AND-combined. Omit to page over all of the caller’s actors.

Type​

ActorsConnection object​

Relay-style cursor-paginated connection over the caller’s actors (Actor). Page with first/after; cursors are opaque.