# Decider Formation Resource

> Creates a decider — a versioned question set answered against a caller's input.

# Decider

> This page is auto-generated from the formations OpenAPI spec.
> Do not edit manually — run `pnpm generate-formations-resource-docs` to regenerate.

Creates a decider — a versioned question set answered against a caller's input. Names exactly one backend: `agent_id` (a tool-less agent) or `tool_id` (an `http` or `pipeline` tool), either a `{ "ref": … }` to a resource in the same template. Only a change to `questions` archives a new version. Mirrors the deciders REST contract.

## Syntax

```yaml
type: decider
properties:
  name: String
  description: String
  agent_id: String
  tool_id: String
  questions: Object[]
```

## Output

The physical resource ID is the **public ID** of the created resource. Reference it from other resources with a `ref` expression:

```yaml
      some_field:
        ref: MyDecider
```

## Properties

**`name`**

Human-readable name, unique per project

_Required_: Yes
_Type_: String

---

**`description`**

Optional description

_Required_: No
_Type_: String
_Nullable_: Yes

---

**`agent_id`**

The tool-less agent that answers

_Required_: No
_Type_: String

---

**`tool_id`**

The http or pipeline tool that answers

_Required_: No
_Type_: String

---

**`questions`**

The questions (`type`, `name`, `instructions`, `choices` or `levels`), 1 to 20 of them, validated as the deciders REST contract validates them.

_Required_: Yes
_Type_: Array of Object

---