# Conversation

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

# Conversation

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

Creates a conversation within the formation's project.

## Syntax

```yaml
type: conversation
properties:
  name: String
  status: String
  actor_id: String
```

## 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: MyConversation
```

## Properties

**`name`**

Human-readable label for the conversation

_Required_: No
_Type_: String
_Nullable_: Yes

---

**`status`**

Initial status of the conversation (open or closed)

_Required_: No
_Type_: String

---

**`actor_id`**

Public ID of an actor to associate with this conversation

_Required_: No
_Type_: String
_Nullable_: Yes

---