v51

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-01214756.7 KB
actors::list

## Datacenter Round Trips

If key is some & include_destroyed is false

2 round trips:

  • namespace::ops::resolve_for_name_global

  • GET /actors (multiple DCs based on actor IDs)

    This path is optimized because we can read the actor IDs fro the key directly from Epoxy with stale consistency to determine which datacenter the actor lives in. Under most circumstances, this means we don't need to fan out to all datacenters (like normal list does).

    The reason include_destroyed has to be false is Epoxy only stores currently active actors. If include_destroyed is true, we show all previous iterations of actors with the same key.

Otherwise

2 round trips:

  • namespace::ops::resolve_for_name_global
  • GET /actors (fanout)

Optimized Alternative Routes

get/actors

Query parameters

namespacestring required
namestring
keystring
actor_idsstring

Deprecated.

actor_idRivetId[]
include_destroyedboolean
limitinteger
cursorstring

Response