Mutation
removeItemFromCollections
Remove an item from one or more collections.
Arguments
- collectionIds [ID!] default []
- IDs of collections to remove the item from, as returned by the
collectionsquery for this workspace. Several id forms are accepted depending on how the workspace stores Collections. An id from another workspace, or one this workspace cannot write through this API, rejects the WHOLE call with a userErrors entry naming the offending id undercollectionIds. - collectionNames [String!] default []
- Names of collections to remove the item from.
- itemId ID! required
- ID of the item to remove from collections.
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.
- item Item
- The updated item.
- aiFilterReasons [AiFilterReason!]!
- Explanations the AI Filters produced for this item's AI-generated custom attributes, one entry per AI-generated attribute the item has. Pair each entry to its value by
keyincustomAttributes;customAttributeSchemasmarks which keys are AI-generated viaaiGenerated. Empty when the item has none. - key String!
- Custom-attribute key this explanation belongs to. Matches a key in
customAttributesand thekeyof acustomAttributeSchemasentry. - reason String
- The AI Filter's explanation for the value it assigned. Null when the run recorded no explanation; an empty string is returned verbatim when the model produced one.
- archivePublicUrl String
- Stable Archive permalink for this item. Unlike
originalUrl, this URL keeps resolving after the source post is deleted or the creator account goes private. - caption String
- Caption text of the content, when available.
- creator Creator!
- Creator who posted this content.
- customAttributes JSON!
- Custom metadata fields associated with the creator (for example CRM attributes).
- id ID!
- Unique identifier for the creator in Archive's system.
- socialProfiles [SocialProfile!]!
- Social media profiles linked to this creator across all platforms (for example Instagram, TikTok, YouTube). Returns an empty list if no profiles are linked.
- accountName String!
- Username or handle of the social media account.
- avatar String
- URL of the account's profile picture, if available.
- creator Creator ↻ circular view Creator →
- Creator associated with this social profile in the current workspace. Use this to get the unified creator ID for deduplicating creators across platforms. Returns null if the profile has no creator record in this workspace.
- email String
- Email address associated with the account, if available.
- followers Int!
- Number of followers on the social media account (when available).
- following Int!
- Number of accounts this profile is following (when available).
- fullName String
- Display name or full name shown on the social media profile.
- id ID!
- Unique identifier of the social profile in Archive's system.
- originalUrl String!
- Direct URL to the profile on the social platform (e.g., https://instagram.com/account_name).
- phoneNumbers [String!]
- Phone numbers associated with the account, when present.
- private Boolean!
- Whether the social media account is currently set to private.
- proAccount Boolean!
- Whether the account is marked as a professional or business account on the platform.
- provider Provider!
- Platform where the social profile exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
- Instagram platform integration, including posts, reels, stories, and profile data.
- INTERNAL
- Internal Archive-managed source used for synthetic or system-generated content.
- TIKTOK
- TikTok platform integration, including videos and creator profile data.
- YOUTUBE
- YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
- verified Boolean!
- Whether the account has a verified/badge status on the platform.
- currentEngagement Engagement
- Most recent engagement metrics (likes, comments, views, shares, EMV) and virality score for this item.
- comments BigInt
- Total number of comments.
- earnedMediaValue BigInt
- Estimated earned media value (EMV) in cents.
- impressions BigInt
- Number of views, plays, or estimated impressions.
- likes BigInt
- Total number of likes.
- linearViralityScore ViralityScore!
- Bucketed virality score.
- HIGH
- Content that significantly outperforms its expected reach. Typically corresponds to a view-to-follower ratio of 4.0 or higher.
- LOW
- Content performing close to expected baseline relative to audience size. Typically corresponds to a view-to-follower ratio between ~1.0 and 2.0.
- MEDIUM
- Content performing above average relative to audience size. Typically corresponds to a view-to-follower ratio between ~2.0 and 4.0.
- NOT_VIRAL
- Content performing below expected reach, with low relative visibility. Typically corresponds to a view-to-follower ratio below ~1.0.
- shares BigInt
- Number of shares.
- views BigInt
- Number of views.
- customAttributes JSON!
- Custom metadata fields associated with the item.
- externalId ID!
- Platform-specific identifier for the content (e.g., Instagram post ID, TikTok video ID).
- hashtags [String!]
- List of hashtags used in the item’s caption or metadata.
- id ID!
- Unique identifier for the item in Archive's system.
- location Location
- Location associated with the content, if present.
- city String
- City associated with the location.
- country String
- Country associated with the location.
- formatted String
- Human-readable formatted address.
- name String
- Full name of the location.
- state String
- State, region, or province associated with the location.
- mediaItemId ID!
- Identifier of the parent media item. Use this to group related contents (e.g., carousel frames) that belong to the same post.
- mentions [String!]
- List of user mentions used in the item’s caption or metadata.
- originalUrl String
- Direct URL to the original content on the social platform. Returns null for content types without public URLs (e.g., Instagram Stories).
- provider Provider!
- Platform where the content exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
- Instagram platform integration, including posts, reels, stories, and profile data.
- INTERNAL
- Internal Archive-managed source used for synthetic or system-generated content.
- TIKTOK
- TikTok platform integration, including videos and creator profile data.
- YOUTUBE
- YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
- socialProfile SocialProfile!
- Social media profile on which this content was posted.
- accountName String!
- Username or handle of the social media account.
- avatar String
- URL of the account's profile picture, if available.
- creator Creator
- Creator associated with this social profile in the current workspace. Use this to get the unified creator ID for deduplicating creators across platforms. Returns null if the profile has no creator record in this workspace.
- customAttributes JSON!
- Custom metadata fields associated with the creator (for example CRM attributes).
- id ID!
- Unique identifier for the creator in Archive's system.
- socialProfiles [SocialProfile!]! ↻ circular view SocialProfile →
- Social media profiles linked to this creator across all platforms (for example Instagram, TikTok, YouTube). Returns an empty list if no profiles are linked.
- email String
- Email address associated with the account, if available.
- followers Int!
- Number of followers on the social media account (when available).
- following Int!
- Number of accounts this profile is following (when available).
- fullName String
- Display name or full name shown on the social media profile.
- id ID!
- Unique identifier of the social profile in Archive's system.
- originalUrl String!
- Direct URL to the profile on the social platform (e.g., https://instagram.com/account_name).
- phoneNumbers [String!]
- Phone numbers associated with the account, when present.
- private Boolean!
- Whether the social media account is currently set to private.
- proAccount Boolean!
- Whether the account is marked as a professional or business account on the platform.
- provider Provider!
- Platform where the social profile exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
- Instagram platform integration, including posts, reels, stories, and profile data.
- INTERNAL
- Internal Archive-managed source used for synthetic or system-generated content.
- TIKTOK
- TikTok platform integration, including videos and creator profile data.
- YOUTUBE
- YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
- verified Boolean!
- Whether the account has a verified/badge status on the platform.
- takenAt DateTime!
- Timestamp when the content was originally published on the social platform (UTC).
- transcriptions [Transcription!]!
- Text transcriptions and subtitles generated for video content within this item.
- mediaContentId ID!
- Identifier of the media content this transcription belongs to.
- transcript String
- Plain text transcription of the spoken content.
- type ItemType!
- Type of archived content (for example POST, REEL, STORY or SHORT), depending on the platform.
- POST
- Standard feed post, such as a single image or carousel post on Instagram.
- REEL
- Short-form vertical video published as a Reel or equivalent format.
- SHORT
- Short-form vertical video such as a YouTube Short or similar format.
- STORY
- Ephemeral story content, typically available for a limited time.
- userErrors [UserError!]!
- List of errors that occurred.
- field [String!]
- Path to the input field that caused the error.
- message String!
- The error message.