# Mutations

Write operations exposed by the Archive GraphQL API, grouped by functional area.

## Items & Media

- [`uploadItemFromUrl`](/api/v2/docs/mutations/upload-item-from-url) — Enqueue a single UGC URL for import into the current workspace.

## Engagement

- [`refetchEngagementBulk`](/api/v2/docs/mutations/refetch-engagement-bulk) — Queue a bulk engagement data refresh for the specified items.

## Collections

- [`addItemToCollections`](/api/v2/docs/mutations/add-item-to-collections) — Add an item to one or more collections.
- [`createCollection`](/api/v2/docs/mutations/create-collection) — Create a Collection (saved tag set) in the current workspace.
- [`deleteCollection`](/api/v2/docs/mutations/delete-collection) — Delete a Collection (strips the tag from items; does not delete items).
- [`moveCollectionToGroup`](/api/v2/docs/mutations/move-collection-to-group) — Move a Collection into a view group, or out (when groupId is null).
- [`removeItemFromCollections`](/api/v2/docs/mutations/remove-item-from-collections) — Remove an item from one or more collections.
- [`updateCollection`](/api/v2/docs/mutations/update-collection) — Rename a Collection in the current workspace.

## Views & View Groups

- [`createContentView`](/api/v2/docs/mutations/create-content-view) — Create a saved content (media deck) view for the current workspace.
- [`createCreatorView`](/api/v2/docs/mutations/create-creator-view) — Create a saved Creator View for the current workspace.
- [`createSocialProfileView`](/api/v2/docs/mutations/create-social-profile-view) — Create a saved Social Profile view for the current workspace.
- [`createViewGroup`](/api/v2/docs/mutations/create-view-group) — Create a user-created view group for the current workspace.
- [`deleteContentView`](/api/v2/docs/mutations/delete-content-view) — Hard-delete a saved content (media deck) view.
- [`deleteCreatorView`](/api/v2/docs/mutations/delete-creator-view) — Hard-delete a saved Creator View.
- [`deleteSocialProfileView`](/api/v2/docs/mutations/delete-social-profile-view) — Hard-delete a saved Social Profile view.
- [`deleteViewGroup`](/api/v2/docs/mutations/delete-view-group) — Hard-delete a user-created view group. Returns the FilterPreset UUIDs whose group membership was removed so clients can invalidate cached views.
- [`moveContentViewToGroup`](/api/v2/docs/mutations/move-content-view-to-group) — Move a saved content (media deck) view into a view group, or out (when groupId is null).
- [`moveCreatorViewToGroup`](/api/v2/docs/mutations/move-creator-view-to-group) — Move a saved Creator View into a view group, or out (when groupId is null).
- [`moveSocialProfileViewToGroup`](/api/v2/docs/mutations/move-social-profile-view-to-group) — Move a saved Social Profile view into a view group, or out (when groupId is null).
- [`reorderViewsInGroup`](/api/v2/docs/mutations/reorder-views-in-group) — Reorder the submitted Content View, Social Profile View, and Creator View ids within the named group. Members omitted from `viewIds` keep their relative order and sort after the listed views.
- [`updateContentView`](/api/v2/docs/mutations/update-content-view) — Partial-update a saved content (media deck) view.
- [`updateCreatorView`](/api/v2/docs/mutations/update-creator-view) — Partial-update a saved Creator View.
- [`updateSocialProfileView`](/api/v2/docs/mutations/update-social-profile-view) — Partial-update a saved Social Profile view.
- [`updateViewGroup`](/api/v2/docs/mutations/update-view-group) — Rename a user-created view group.

## Webhooks

- [`createWebhookSubscription`](/api/v2/docs/mutations/create-webhook-subscription) — Create an outbound-webhook subscription. Returns the signing secret exactly once.
- [`deleteWebhookSubscription`](/api/v2/docs/mutations/delete-webhook-subscription) — Hard-delete a webhook subscription (cascades its deliveries).
- [`enableWebhookSubscription`](/api/v2/docs/mutations/enable-webhook-subscription) — Re-enable a subscription auto-disabled by failures; optionally replay the last 24h of failures.
- [`redeliverWebhookDelivery`](/api/v2/docs/mutations/redeliver-webhook-delivery) — Manually replay a terminal failed delivery (one-shot).
- [`rotateWebhookSubscriptionSecret`](/api/v2/docs/mutations/rotate-webhook-subscription-secret) — Rotate a webhook subscription signing secret. Returns the new secret once.
- [`sendWebhookTestEvent`](/api/v2/docs/mutations/send-webhook-test-event) — Send a signed synthetic ping to a subscription's endpoint and return the settled delivery.
- [`updateWebhookSubscription`](/api/v2/docs/mutations/update-webhook-subscription) — Partial-update a webhook subscription.