---
title: "Create Channel Agent"
method: POST
path: "/channels/agents/"
tags: ["Channels"]
---

# Create Channel Agent

`POST /channels/agents/`

## Request body

- ChannelAgentRequest
  - `agent` ChannelAgentCreate, required
    - `flags` ChannelAgentFlags
      - `is_active` boolean
      - `is_default` boolean
    - `tags` object, nullable
    - `meta` object, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `slug` string, nullable
    - `connection_id` string, uuid, required
    - `data` ChannelAgentData, required
      - `references` object, required
      - `policy` ChannelPolicy — What one level STATED. Every field optional; None means no opinion.
        - `triggers` ChannelTriggerKind[], nullable
        - `session_scope` 'thread' | 'message'
        - `backfill` boolean, nullable
        - `forwardfill` boolean, nullable
      - `tools` ChannelAgentToolSettings — What the channel agent tools may do through this bot. Permissive by default: a bot saved before this block existed reads as these values.
        - `can_post_outside_conversation` boolean
        - `readable_space_keys` string[], nullable

## Response `200`

Successful Response

- ChannelAgentResponse
  - `count` integer
  - `agent` ChannelAgent
    - `flags` ChannelAgentFlags
      - `is_active` boolean
      - `is_default` boolean
    - `tags` object, nullable
    - `meta` object, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `created_by_id` string, uuid, nullable
    - `updated_by_id` string, uuid, nullable
    - `deleted_by_id` string, uuid, nullable
    - `slug` string, nullable
    - `id` string, uuid, nullable
    - `connection_id` string, uuid, required
    - `data` ChannelAgentData, required
      - `references` object, required
      - `policy` ChannelPolicy — What one level STATED. Every field optional; None means no opinion.
        - `triggers` ChannelTriggerKind[], nullable
        - `session_scope` 'thread' | 'message'
        - `backfill` boolean, nullable
        - `forwardfill` boolean, nullable
      - `tools` ChannelAgentToolSettings — What the channel agent tools may do through this bot. Permissive by default: a bot saved before this block existed reads as these values.
        - `can_post_outside_conversation` boolean
        - `readable_space_keys` string[], nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `ec21cdc5486c` — 2 info
  - added the new optional request property `agent/data/tools`
  - added the optional property `agent/anyOf[subschema #1: ChannelAgent]/data/tools` to the response with the `200` status
- **2026-09-24** `a28f1d059149` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/channels/agents/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/72f2feba8ccb?raw)