> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Migration Split Request Policy

> Change whether the request's call settings or the agent's win on traffic a migration split sends to an agent.

Changes only the `request_policy` of an existing migration split. The share of traffic and the agent stay as they are, so this request is accepted while a rollout is moving the pathway's share. The new policy applies from the next call. [Set Migration Split](https://docs.bland.ai/api-v1/put/convo-pathway-id-migration-split.md) describes what each policy does.

Requires an admin, owner, or operator role.

### Headers

**authorization** `string` *required*

Your API key for authentication.

**content-type** `string` *required*

Must be `application/json`.

### Path Parameters

**pathway\_id** `string` *required*

The V1 pathway. Must be a UUID of a pathway in your organization. Returns `400 BAD_REQUEST` for an invalid UUID, `404 NOT_FOUND` for a pathway outside your organization, and `400 BAD_REQUEST` for a pathway that Bland compiled from a V2 agent.

### Body Parameters

**request\_policy** `string` *required*

`honor` (the request's call settings win) or `agent_owned` (the agent's settings win). Any other value, or a missing value, returns `400 BAD_REQUEST`.

### Response

**data.migration\_split** `object`

The split after the change.

**migration split object**

**agent\_id** `string`

The agent that receives the split traffic.

**v2\_percentage** `integer`

Percentage of the pathway's traffic sent to the agent.

**request\_policy** `string`

The new policy.

**updated\_at** `string`

ISO 8601 timestamp of the last change.

**rollout\_id** `string | null`

ID of the rollout that is moving this pathway's share, or `null` when no rollout is in progress.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed. Returns `404 NOT_FOUND` when the pathway has no split. Create one with [Set Migration Split](https://docs.bland.ai/api-v1/put/convo-pathway-id-migration-split.md).

```json Request theme={null}
{
  "request_policy": "agent_owned"
}
```

```json Response theme={null}
{
  "data": {
    "migration_split": {
      "agent_id": "6f2c8a41-3b7e-4d19-9c55-0e8a1f3b7d24",
      "v2_percentage": 50,
      "request_policy": "agent_owned",
      "updated_at": "2026-11-12T19:22:07.845Z",
      "rollout_id": "0c6d3f9e-58a2-4b7f-a1d4-93e2b6c7f510"
    }
  },
  "errors": null
}
```

```json Invalid Body theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "BAD_REQUEST",
      "message": "request_policy must be 'honor' or 'agent_owned'"
    }
  ]
}
```

```json No Split theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Migration split not found"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.