---
title: "Approve Agent Channel"
method: POST
path: "/api/v1/campaigns/{campaign_id}/agent-channel/approve"
tags: ["campaigns"]
---

# Approve Agent Channel

`POST /api/v1/campaigns/{campaign_id}/agent-channel/approve`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/campaigns/{campaign_id}/agent-channel/approve`
- Auth: none declared

Freeze the working copy into what agents read. 422 lists what is
missing; 409 when nothing changed since the last approval.

## Path parameters

- `campaign_id` string, uuid, required

## Request body

- AgentChannelApprove: Approve this version of the working copy (``AgentChannelRead.version``).
  - `version` string, required

## Response `200`

Successful Response

- AgentChannelRead: A campaign's agent channel as people see it: the working copy in local time, its sign-off, and whether it differs from what agents are using.
  - `campaign_id` string, uuid, required
  - `name` string, required
  - `external_ref` string, nullable, required
  - `timezone` string, required
  - `raise_mode` 'when_asked' | 'when_relevant' | 'end_of_booking', required: When an agent brings a live campaign up (PLAN-agent-campaigns).
  - `priority` integer, required
  - `disclaimer` string, nullable, required
  - `call_to_action` string, nullable, required
  - `never_say` string, nullable, required
  - `phases` AgentPhaseRead[], required
    - `name` string, required
    - `starts_local` string, date-time, required
    - `ends_local` string, date-time, required
    - `details_for` 'nobody' | 'group' | 'everyone', required: Who hears a phase's offer details. Everyone else hears its message.
    - `group_id` string, uuid, nullable
    - `message` string, nullable
    - `position` integer, required
  - `offers` AgentOfferWrite[], required
    - `property_id` string, uuid, required
    - `offer` string, nullable
    - `stay_starts_on` string, date, nullable
    - `stay_ends_on` string, date, nullable
  - `voice_agent_group_ids` string[], required
  - `text_widget_group_ids` string[], required
  - `approved_at` string, date-time, nullable, required
  - `approved_by_name` string, nullable, required
  - `switched_off_at` string, date-time, nullable, required
  - `switched_off_by_name` string, nullable, required
  - `last_edited_by_user_id` string, uuid, nullable, required
  - `has_unapproved_changes` boolean, required
  - `readiness` ReadinessItem[], required
    - `key` string, required
    - `label` string, required
    - `section` 'schedule' | 'hotels' | 'wording' | 'agents', required
  - `status` AgentStatusRead, required: Where a campaign's agent channel stands, with what the status sentence needs. Times are tenant-local, from the approved snapshot once there is one, else from the working copy.
    - `status` 'archived' | 'switched_off' | 'ended' | 'live' | 'approved' | 'needs_approval' | 'draft', required: Where a campaign's agent channel stands, highest precedence first: archived > switched_off > ended > live > approved > needs_approval > draft (PLAN-agent-campaigns, State x role).
    - `timezone` string, required
    - `current_phase_name` string, nullable, required
    - `current_phase_ends_local` string, date-time, nullable, required
    - `first_starts_local` string, date-time, nullable, required
    - `last_ends_local` string, date-time, nullable, required
    - `has_unapproved_changes` boolean, required
    - `readiness_left` integer, required
    - `ready_since` string, date-time, nullable, required
    - `switched_off_at` string, date-time, nullable, required
    - `switched_off_by_name` string, nullable, required
    - `approved_at` string, date-time, nullable, required
    - `approved_by_name` string, nullable, required
  - `now` string, date-time, required
  - `version` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-18** `4e699bbdcfbd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/campaigns/:campaign_id/agent-channel/approve/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) - [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4e699bbdcfbd?raw)
