/agents/{agentId}/states/{stateId}

post

https://api.rcsstudio.ai/agents/{agentId}/states/{stateId}

Create a new state with the given ID. Fails if a state with this ID already exists; use PUT to update.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

agentId

string

required

stateId

string

required

Body Params

Body

flowId

uuid

ID of the flow this state belongs to. A state belongs to at most one flow. It can be moved to a different flow, but cannot be unassigned. A flow's entry-point state cannot be moved until the flow's entry point is changed. The first state to join a flow becomes its entry point.

operations

array of objects | null

Ordered list of connector operations executed when entering this state.

operations

template

object

RCS message template. When the agent reaches this state, the template is rendered into a message and sent to the user. Liquid expressions like {{ params.firstName }} or {{ data.userEmail }} resolve from the current context.

transitions

array of objects | null

Ordered list of conditional transitions evaluated when entering this state. The first matching condition routes to its nextState.

transitions

input

object | null

Defines how the user’s next reply is captured into context and which state the reply routes to.

params

array of objects | null

Ordered list of parameters declared on this state. Available in templates as {{ params.<key> }}.

params

Responses

200200

422422