Query

collection

Return a single Collection by ID for the current workspace, or null if no such Collection exists here.

MCP: getCollection

Arguments

id ID! required: ID of the Collection to fetch, as returned by the collections query for this workspace.

Returns

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

createdAt DateTimeWithZone!: When the Collection was created.
customAttributeOptionId ID: Id of the option that represents this Collection in the ITEM collections custom attribute schema (customAttributeSchemas(entity: ITEM)). It differs from id: use it as the value of a collections custom-attribute condition and to match values in an item's customAttributes. Null for workspaces whose Collections use the older storage.
group ViewGroup: Group this Collection belongs to, or null when ungrouped. Populated by moveCollectionToGroup. Always null for workspaces whose Collections use the older storage.
collections [Collection!]!: Collections that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the Collection was created.
customAttributeOptionId ID: Id of the option that represents this Collection in the ITEM collections custom attribute schema (customAttributeSchemas(entity: ITEM)). It differs from id: use it as the value of a collections custom-attribute condition and to match values in an item's customAttributes. Null for workspaces whose Collections use the older storage.
group ViewGroup ↻ circular view ViewGroup →: Group this Collection belongs to, or null when ungrouped. Populated by moveCollectionToGroup. Always null for workspaces whose Collections use the older storage.
id ID!: Unique identifier of the Collection in this workspace. Pass it to addItemToCollections / removeItemFromCollections and to collection(id:).
itemCount Int!: Number of items in this workspace tagged with the Collection.
name String!: Display name of the Collection.
updatedAt DateTimeWithZone!: When the Collection was last updated.
contentViews [ContentView!]!: Content Views that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set, as stored: operator and type hold the lowercase stored values (e.g. "is_not_empty", "text_list"), not the FilterOperator / CustomAttributeType names. The view create and update mutations accept these stored values when the list is passed back as customAttributeConditions through variables, but they validate it as they would any other input: a list the app saved can be refused (for example a list condition with no values, more conditions or values than the limits allow, or a condition on an attribute the workspace no longer has or whose type no longer matches), so check the userErrors when cloning a view this way.
filters JSON!: Opaque filter blob defining which items belong to the view.
group ViewGroup ↻ circular view ViewGroup →: Group this view belongs to, or null when the view is ungrouped. Populated by moveContentViewToGroup.
id ID!: Unique identifier (FilterPreset UUID). Use this with items(presetId:).
name String!: Display name of the view.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing items via this view. Each entry is { field, direction }: field is one of taken_at, merged_view_play_count, like_count, comment_count, share_count, earned_media_value, linear_virality, exponential_virality, resolved_virality, account_name, followers_count; direction is ASC or DESC (case-insensitive).
updatedAt DateTimeWithZone!: When the view was last updated.
createdAt DateTimeWithZone!: When the group was created.
creatorViews [CreatorView!]!: Creator Views that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set, as stored: operator and type hold the lowercase stored values (e.g. "is_not_empty", "text_list"), not the FilterOperator / CustomAttributeType names. The view create and update mutations accept these stored values when the list is passed back as customAttributeConditions through variables, but they validate it as they would any other input: a list the app saved can be refused (for example a list condition with no values, more conditions or values than the limits allow, or a condition on an attribute the workspace no longer has or whose type no longer matches), so check the userErrors when cloning a view this way.
filters JSON!: Opaque filter blob, stored and echoed back. creators(presetId:) applies it only with applyViewFilters: true; otherwise it narrows only by this view's customAttributeConditions and sort. Use customAttributeConditions to filter which creators the view returns.
group ViewGroup ↻ circular view ViewGroup →: Group this view belongs to, or null when the view is ungrouped. Populated by moveCreatorViewToGroup.
id ID!: Unique identifier of this saved view. Use the returned id with creators(presetId:) to fetch the view's creators.
name String!: Display name of the view.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing creators via this view.
updatedAt DateTimeWithZone!: When the view was last updated.
id ID!: Unique identifier.
name String!: Display name of the group.
socialProfileViews [SocialProfileView!]!: Social Profile Views that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set, as stored: operator and type hold the lowercase stored values (e.g. "is_not_empty", "text_list"), not the FilterOperator / CustomAttributeType names. The view create and update mutations accept these stored values when the list is passed back as customAttributeConditions through variables, but they validate it as they would any other input: a list the app saved can be refused (for example a list condition with no values, more conditions or values than the limits allow, or a condition on an attribute the workspace no longer has or whose type no longer matches), so check the userErrors when cloning a view this way.
filters JSON!: Opaque filter blob, stored and echoed back. socialProfiles(presetId:) applies it only with applyViewFilters: true; otherwise it narrows only by this view's customAttributeConditions and sort. Use customAttributeConditions to filter which social profiles the view returns.
group ViewGroup ↻ circular view ViewGroup →: Group this view belongs to, or null when the view is ungrouped. Populated by moveSocialProfileViewToGroup.
id ID!: Unique identifier of this saved view. Use the returned id with socialProfiles(presetId:) to fetch the view's social profiles.
name String!: Display name of the view.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing social profiles via this view. Each entry is { field, direction }: field is one of media_items_taken_at_max, followers_count, source_tracking, source_content, source_tracking_until, source_last_pulled_at, account_name; direction is ASC or DESC (case-insensitive).
updatedAt DateTimeWithZone!: When the view was last updated.
updatedAt DateTimeWithZone!: When the group was last updated.
id ID!: Unique identifier of the Collection in this workspace. Pass it to addItemToCollections / removeItemFromCollections and to collection(id:).
itemCount Int!: Number of items in this workspace tagged with the Collection.
name String!: Display name of the Collection.
updatedAt DateTimeWithZone!: When the Collection was last updated.

{ "data": { "collection": { "id": "122321ce-843e-5b07-9f56-94323c0ae39e", "name": "Best Sellers", "itemCount": 3, "createdAt": "2024-12-31T21:00:00Z", "updatedAt": "2024-12-31T21:00:00Z" } } }