---
title: "Replace approval routing"
method: PUT
path: "/v1/projects/{project_id}/approvals/routing-config"
tags: ["approvals"]
---

# Replace approval routing

`PUT /v1/projects/{project_id}/approvals/routing-config`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/approvals/routing-config`
- Auth: HTTP bearer

Replace an environment's member notification settings and approval channel routes in one change.

Omit `channel_routes` or send null to keep the current channel routes.
Sending `channel_routes` requires an Enterprise plan.

Required permission: `approvals.configure`. Passing `channel_routes` also requires `channels.manage`.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `environment_id` string, uuid, required: Environment whose approval routing to replace.

## Request body

- ApprovalRoutingConfigUpdate: Replaces member approval notifications and, optionally, channel routes for an environment in one request.
  - `configs` ApprovalNotificationConfigUpdate[]: Member notification settings. Replaces all existing settings for the environment.
    - `agent_name` string, required: Agent whose approval requests trigger the notification; `*` for all agents.
    - `user_id` string, nullable: Project member to notify. null applies to all members.
    - `enabled` boolean: Whether the member receives these notifications.
  - `channel_routes` ApprovalChannelRouteUpdate[], nullable: Channel routes. Replaces all existing routes for the environment; null keeps them.
    - `channel_id` string, uuid, required: Channel in the project that receives the approval requests.
    - `agent_name` string: Agent whose approval requests are routed; `*` for all agents.
    - `enabled` boolean: Whether requests are delivered through this route.

## Response `200`

Successful Response

- PublicApprovalRoutingResponse
  - `configs` ApprovalNotificationConfigResponse[], required: Member notification settings for approval requests in the environment.
    - `id` string, uuid, required
    - `environment_id` string, uuid, required: Environment the setting applies to.
    - `agent_name` string, required: Agent whose approval requests trigger the notification; `*` for all agents.
    - `user_id` string, nullable: Project member to notify. null applies to all members.
    - `enabled` boolean, required: Whether the member receives these notifications.
  - `channel_routes` ApprovalChannelRouteResponse[], required: Channel routes that deliver approval requests in the environment.
    - `id` string, uuid, required
    - `environment_id` string, uuid, required: Environment whose approval requests are routed.
    - `channel_id` string, uuid, required: Channel that receives the approval requests.
    - `agent_name` string, required: Agent whose approval requests are routed; `*` for all agents.
    - `enabled` boolean, required: Whether requests are delivered through this route.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)