Skip to main content
Are.na logo
  • Category: bookmark managers
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: ARENA
  • Version: 20261030_00

Tools

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

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_CREATE_CHANNELCreate a user-owned Are.na channel, closed by default, and return its stable numeric ID and generated slug.

Input Parameters

string
required
Channel title. Are.na generates the channel slug from this value.
object
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.
string ("public" | "private" | "closed")
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.
string
Optional Markdown description for the channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_DELETE_CHANNELPermanently delete one Are.na channel the authenticated user is allowed to destroy. This cannot be undone.

Input Parameters

string
required
Numeric channel ID or slug. Prefer the numeric ID after an update because changing the title regenerates the slug.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_GET_BLOCKGet the details of one Are.na block by ID, including its subtype, content, source, creator, and metadata.

Input Parameters

integer
required
Block ID, typically obtained from channel contents or the feed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_GET_CHANNELGet an Are.na channel by numeric ID or slug, including visibility, counts, owner, and the current user’s permissions.

Input Parameters

string
required
Numeric channel ID or channel slug.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_GET_CURRENT_USERReturn the identity and account details for the authenticated Are.na user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_GET_MY_FEEDReturn 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

integer
Maximum feed items to return in this page (1-100).
string
Cursor returned by a previous call. Pass it to fetch the next page toward older feed items; omit it for the newest page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_LIST_CHANNEL_CONTENTSReturn one page of blocks and nested channels from an Are.na channel, with optional sorting and contributor filtering.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_REMOVE_FROM_CHANNELRemove 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

integer
required
Connection ID returned by Add To Channels or embedded in a channel content item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ARENA_UPDATE_CHANNELUpdate selected fields of an Are.na channel the authenticated user can edit. Fields omitted from the request remain unchanged.

Input Parameters

string
New channel title. Updating it also changes the channel slug.
object
Metadata changes to merge into the channel. New keys are added, existing keys are updated, and keys assigned null are removed.
string
required
Numeric channel ID or current channel slug. Prefer the numeric ID because changing the title also changes the slug.
string ("public" | "private" | "closed")
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.
string
New Markdown channel description. Pass null explicitly to clear it; omit this field to leave the current description unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not