Connects a block or channel to one or more channels. Returns the created connection(s).
Specify target channels using either channels (preferred) or channel_ids (legacy), but not both.
The channels form allows per-channel position and connection metadata.
Authentication required.
Body Params
connectable_id
integer
required
ID of the block or channel to connect.
connectable_type
enum
required
Type of entity that can be connected to a channel. - `Block`: A block - `Channel`: A channel
channel_ids
array
Array of channel IDs or slugs. Accepts numeric IDs, string IDs, or channel slugs (e.g., `[123, "456", "my-channel-slug"]`).
position
integer
Position to insert at within the channel (1-indexed). Only valid when connecting to a single channel.
channels
ConnectTo[]
Target channels with optional per-channel position and connection metadata.
POST
https://api.are.na/v3/connections
data
Connection[]
[items]
Connection
Full connection resource with abilities and links.
id
integer!
Unique identifier for the connection
position
integer!
Position of the item within the channel (1-indexed)
pinned
boolean!
Whether the item is pinned
metadata
Metadata
Custom key-value metadata
connected_at
string (date-time)!
When the item was connected
connected_by
EmbeddedUser!
User who created this connection
can
ConnectionAbilities!
Actions the current user can perform on this connection
_links
Links!
HATEOAS links for navigation and discovery.