v51

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

## Datacenter Round Trips

If actor exists

2 round trips:

  • namespace::ops::resolve_for_name_global
  • GET /actors/{}

If actor does not exist and is created in the current datacenter:

2 round trips:

  • namespace::ops::resolve_for_name_global
  • [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)

If actor does not exist and is created in a different datacenter:

3 round trips:

  • namespace::ops::resolve_for_name_global
  • POST /actors to remote datacenter
  • [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)

actor::get will always be in the same datacenter.

Optimized Alternative Routes

put/actors

Query parameters

namespacestring required

Request body

crash_policy'restart' | 'sleep' | 'destroy' required
datacenterstring nullable
inputstring nullable
keystring required
namestring required
runner_name_selectorstring required

Response

createdboolean required