Create a route

POST 
/v1/projects/:project_id/channels/:channel_id/routes

action is required; agent_id is required when it is agent, text when it is message; repeat is only valid alongside action: message. surface, when present, must be one this channel's kind serves (GET /v1/channel-kinds) — otherwise 400 unknown_surface. match keys must be predicates that kind's registry declares — otherwise 400 unknown_predicate. Writing a route for a surface whose transport mode is off (e.g. a Discord guild_thread route before mention_threads is enabled) still succeeds, with unreachable_surface in the response warnings.

Request

Responses

201

Route created.

400

The request was malformed or failed validation.

401

Missing or invalid credentials.

404

The resource does not exist (existence is not leaked).

409

The request conflicts with the resource's current state.