Connects a block or channel to one or more channels. Returns the created connection(s).
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
required
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. Only valid when connecting to a single channel.
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
pinned
boolean!
Whether the item is pinned
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.