---
title: "Create Channel Grant"
method: POST
path: "/channels/grants/"
tags: ["Channels"]
---

# Create Channel Grant

`POST /channels/grants/`

## Request body

- ChannelGrantRequest
  - `grant` ChannelGrantCreate, required
    - `flags` ChannelGrantFlags
      - `is_default` boolean
    - `tags` object, nullable
    - `meta` object, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `agent_id` string, uuid, required
    - `effect` 'allow' | 'deny', required
    - `kind` 'private' | 'group' | 'topic'
    - `space_id` string, uuid, nullable
    - `data` ChannelGrantData, 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

## Response `200`

Successful Response

- ChannelGrantResponse
  - `count` integer
  - `grant` ChannelGrant
    - `flags` ChannelGrantFlags
      - `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
    - `id` string, uuid, nullable
    - `agent_id` string, uuid, required
    - `effect` 'allow' | 'deny', required
    - `kind` 'private' | 'group' | 'topic'
    - `space_id` string, uuid, nullable
    - `data` ChannelGrantData, 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

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `a28f1d059149` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/channels/grants/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)