---
canonical_url: "https://docs.composio.dev/toolkits/arena"
markdown_url: "https://docs.composio.dev/toolkits/arena.md"
product: "platform"
version: null
last_updated: null
---

# Are.na

Are.na is a platform for collecting, organizing, and connecting ideas, images, links, and other creative research.

- **Category:** bookmark managers
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `ARENA`
- **Version:** 00000000_00

## Tools

### Add To Channels

**Slug:** `ARENA_ADD_TO_CHANNELS`

Add an existing Are.na block or channel to one or more target channels without duplicating the underlying resource.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `position` | integer | No | Optional 1-based insertion position. Valid only when channel_ids contains exactly one target channel. |
| `channel_ids` | array | Yes | One to 20 target channel identifiers. Each may be a numeric ID, a numeric string ID, or a channel slug. |
| `connectable_id` | integer | Yes | Numeric ID of the existing block or channel to add. |
| `connectable_type` | string ("Block" | "Channel") | Yes | Type of the existing resource to add: Block or Channel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Channel

**Slug:** `ARENA_CREATE_CHANNEL`

Create a user-owned Are.na channel, closed by default, and return its stable numeric ID and generated slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Channel title. Are.na generates the channel slug from this value. |
| `metadata` | object | No | Optional custom metadata with up to 50 alphanumeric or underscore keys. Keys may be at most 40 characters; values must be strings, numbers, or booleans, and string values may be at most 2,000 characters. |
| `visibility` | string ("public" | "private" | "closed") | No | Channel visibility: public allows anyone to view and add content; private limits viewing to the owner and collaborators; closed allows anyone to view but only collaborators to add content. Defaults to closed. |
| `description` | string | No | Optional Markdown description for the channel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Channel

**Slug:** `ARENA_DELETE_CHANNEL`

Permanently delete one Are.na channel the authenticated user is allowed to destroy. This cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | Numeric channel ID or slug. Prefer the numeric ID after an update because changing the title regenerates the slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block

**Slug:** `ARENA_GET_BLOCK`

Get the details of one Are.na block by ID, including its subtype, content, source, creator, and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `block_id` | integer | Yes | Block ID, typically obtained from channel contents or the feed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Channel

**Slug:** `ARENA_GET_CHANNEL`

Get an Are.na channel by numeric ID or slug, including visibility, counts, owner, and the current user's permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | Numeric channel ID or channel slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `ARENA_GET_CURRENT_USER`

Return the identity and account details for the authenticated Are.na user.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get My Feed

**Slug:** `ARENA_GET_MY_FEED`

Return one page of the authenticated user's personalized Are.na activity feed, newest first. Call again with next_cursor only when another page is needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum feed items to return in this page (1-100). |
| `next_cursor` | string | No | Cursor returned by a previous call. Pass it to fetch the next page toward older feed items; omit it for the newest page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Channel Contents

**Slug:** `ARENA_LIST_CHANNEL_CONTENTS`

Return one page of blocks and nested channels from an Are.na channel, with optional sorting and contributor filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("position_asc" | "position_desc" | "created_at_asc" | "created_at_desc" | "updated_at_asc" | "updated_at_desc") | No | Content order. Use position_asc for the owner's manual order, position_desc for its reverse, or a created_at/updated_at order. |
| `user_id` | integer | No | Only return content added by this Are.na user ID. |
| `per_page` | integer | No | Maximum contents to return in this page (1-100). |
| `channel_id` | string | Yes | Numeric channel ID or channel slug. |
| `next_cursor` | string | No | Continuation cursor containing the next page number and current filters; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove From Channel

**Slug:** `ARENA_REMOVE_FROM_CHANNEL`

Remove one block or nested channel placement from an Are.na channel. This deletes only the connection; the underlying block or channel remains intact and may still exist in other channels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connection_id` | integer | Yes | Connection ID returned by Add To Channels or embedded in a channel content item. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Channel

**Slug:** `ARENA_UPDATE_CHANNEL`

Update selected fields of an Are.na channel the authenticated user can edit. Fields omitted from the request remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | New channel title. Updating it also changes the channel slug. |
| `metadata` | object | No | Metadata changes to merge into the channel. New keys are added, existing keys are updated, and keys assigned null are removed. |
| `channel_id` | string | Yes | Numeric channel ID or current channel slug. Prefer the numeric ID because changing the title also changes the slug. |
| `visibility` | string ("public" | "private" | "closed") | No | New channel visibility: public allows anyone to view and add content; private limits viewing to the owner and collaborators; closed allows anyone to view but only collaborators to add content. |
| `description` | string | No | New Markdown channel description. Pass null explicitly to clear it; omit this field to leave the current description unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |