---
title: "Move"
description: "one proposed carrying out of a play: its forecast, its actions, its assignments, its effect"
section: concepts
address: /concepts/move
contract: 0476e35e6e275db5
---

# Move

one proposed carrying out of a play: its forecast, its actions, its assignments, its effect

[figure: Move is a work at strategy scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | work |
| scope | strategy |
| key | the play's version and the catch |
| store | postgres |
| family | strategy |



## Fields


| field | type | required | note |
|---|---|---|---|
| `play` | `id` | yes |  |
| `play_version` | `count` | yes |  |
| `vertex` | `text` | no | the vertex of the play's graph this move carries out; absent for a play whose graph is one move |
| `catch` | `id` | no |  |
| `kinds_of_action` | [KindOfAction](/concepts/kindofaction) | yes |  |
| `voice` | `id` | no |  |
| `what_is_said` | `text` | no |  |
| `proof` | `text` | no | the proof this buyer accepts |
| `price` | [Cost](/concepts/cost) | yes |  |
| `forecast` | [Forecast](/concepts/forecast) | no | withheld when there is no like population |
| `forecast_withheld_because` | `text` | no |  |
| `code` | `text` | no | the code it minted |
| `assignments` | [Assignment](/concepts/assignment) | yes |  |
| `actions` | `[id]` | yes |  |
| `effect` | [Effect](/concepts/effect) | no |  |
| `hypothesis` | `id` | no |  |
| `decided_by` | [Caller](/concepts/caller) | no |  |
| `frame` | [SaleFrame](/concepts/saleframe) | no | the sale framed for this buyer |
| `kind` | [KindOfMove](/concepts/kindofmove) | yes |  |
| `actor` | `id` | no | the Actor routed by propensity, or waiting to be assigned |
| `content` | `id` | no | the content chosen by propensity |
| `graph` | [GraphEdge](/concepts/graphedge) | yes | the edges between its actions; empty for a list |
| `propensities` | `[id]` | yes | the PropensityToMove facts that chose the actor and the content, with their odds |



## Routes that use it
- [`/v1/act/act_through_connector`](/reference/act/act_through_connector) returns it
- [`/v1/act/decide_move`](/reference/act/decide_move) returns it
- [`/v1/act/propose_move`](/reference/act/propose_move) returns it
- [`/v1/act/undo_action`](/reference/act/undo_action) returns it