Archive a Video

Hide one finalized video from the account's public profile without deleting it:

• TikTok: the post is set to Only you.
• Instagram: the post or Reel is archived.

The account's manager does it on the account. TokPortal then checks automatically that the post is no longer public before marking it archived. The video keeps its views and can be restored later on request.

Cost: 1 credit per video.

Request an archive

POST /videos/:id/archive-request

The :id is a video ID (the finalized video to hide), not a bundle ID. No request body is needed.

Prerequisites

• The video must be finalized
• The video must be on TikTok or Instagram and have a post link
• The saved account must have active TokPortal Coverage or be permanently grandfathered
• An active account manager must be available for the account (same rules as account edit requests and ad code requests)
• No other archive request can be open for the same video, and a video is archived only once
• You need at least 1 credit in your balance

Coverage validation, manager assignment, the 1-credit debit and request creation commit atomically. A failed prerequisite never creates a request and never charges.

The request appears directly in the manager's Calendar on the current day, under the account. It is not a marketplace task.

curl -X POST https://app.tokportal.com/api/ext/videos/{video_id}/archive-request \
  -H "X-API-Key: sk_xxx"

Response (201)

{
  "data": {
    "archive_request_id": "uuid",
    "video_id": "uuid",
    "status": "pending",
    "platform": "tiktok",
    "archived": false,
    "created_at": "2026-10-20T10:22:00Z",
    "submitted_at": null,
    "archived_at": null,
    "cancelled_at": null
  },
  "credits_charged": 1,
  "credits_remaining": 1240
}

Send the X-TokPortal-Dry-Run: true header to validate the request (ownership, Coverage, manager, duplicates) without charging or creating anything. See Sandbox.

Get / poll the status

GET /videos/:id/archive-request

Returns the latest archive request for the video, or null when none exists. archived becomes true once TokPortal has verified the post is no longer public.

curl https://app.tokportal.com/api/ext/videos/{video_id}/archive-request \
  -H "X-API-Key: sk_xxx"

Response (200)

{
  "data": {
    "archive_request_id": "uuid",
    "video_id": "uuid",
    "status": "finalized",
    "platform": "tiktok",
    "archived": true,
    "created_at": "2026-10-20T10:22:00Z",
    "submitted_at": "2026-10-20T11:04:00Z",
    "archived_at": "2026-10-20T11:12:00Z",
    "cancelled_at": null
  }
}

Statuses

TIP: How the check works TokPortal only checks after the manager confirms. Two concordant checks a few minutes apart are required before a request is finalized or sent back, so a temporary platform glitch never decides on its own.

Errors

NOTE: Dashboard In the dashboard, open the account's Videos tab and choose Archive video in the options of a finalized video, or use Archive in the video's sheet on the Calendar. Archived videos show the Archived status everywhere.