Skip to main content

Discussion

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

Declares a discussion (deliberation config) within the formation's project. Providing participants replaces the full set on update.

Syntax​

type: discussion
properties:
  name: String
  description: String
  ai_provider_id: String
  model: String
  max_rounds: Integer
  synthesis: Object
  participants: Object[]

Output​

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

      some_field:
        ref: MyDiscussion

Properties​

name

Display name of the discussion

Required: Yes Type: String

description

Required: No Type: String Nullable: Yes

ai_provider_id

Default AI provider participants and synthesis fall back to. Omit (or declare null) to inherit the project's default_model_route_id, which requires the project to have one.

Required: No Type: String Nullable: Yes

model

Default model (falls back to the provider's default_model)

Required: No Type: String Nullable: Yes

max_rounds

Rounds of deliberation (1–3, default 1)

Required: No Type: Integer Nullable: Yes

synthesis

Override for the final synthesis pass

Required: No Type: Object Nullable: Yes

participants

The deliberation participants (max 5)

Required: No Type: Array of Object