---
title: "Upload Cookie File"
method: POST
path: "/api/cookies/upload"
tags: ["cookies"]
---

# Upload Cookie File

`POST /api/cookies/upload`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/cookies/upload`
- Auth: HTTP bearer

Upload a new cookie file for authenticated TikTok scraping.

The cookies should be in Playwright-compatible format with fields:
- name, value, domain, path, expires, httpOnly, secure, sameSite

Empty cookie arrays and missing filenames are rejected with 422 via the
schema's Field constraints — see api/schemas/cookies.py.

## Request body

- CookieUploadRequest: Request body for uploading a cookie file.
  - `filename` string, required: Name of the cookie file
  - `cookies` object[], required: Array of cookie objects (Playwright format) — must be non-empty
  - `description` string, nullable: Optional description

## Response `201`

Successful Response

- CookieFileResponse: Response model for cookie file information.
  - `id` string, required
  - `api_key_id` string, required
  - `filename` string, required
  - `upload_time` string, date-time, required
  - `is_active` boolean, required
  - `description` string, nullable, required
  - `last_used_time` string, date-time, nullable, required
  - `cookie_count` integer, required: Number of cookies in the file

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)