Изменить доступ и ссылку

PATCH/api/v1/content/{id}

Доступ: Ключ API
Право: content:write

Название и теги, доступ, пароль, одноразовое открытие, срок, лимит просмотров и кнопка скачивания. Точная дата конца (expiresAt) и лимит просмотров — функции Pro link_expiry и view_limit; без них ответ 403 PLAN_FEATURE_REQUIRED с params.feature. Непереданные поля не меняются.

Пример запроса

curl -X PATCH "https://lac.pics/api/v1/content/Xq3u9RkT0bLmA7cV2pWz1eFy" \
  -H "Authorization: Bearer lac_api_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "visibility": "unlisted",
  "password": "correct-horse-7",
  "ttl": "week"
}'

Параметры

Путь

idstringобязательный
id файла или заметки.

Тело запроса

application/jsonобязательный

tagsмассив string
До 10 тегов по 1–32 символа: NFKC, без крайних пробелов, повторы и регистр схлопываются. При изменении: не передал — теги остаются, пустой массив — очищает.
до 10 элементов · без повторов
titlestring
Название, до 180 символов.
не длиннее 180
visibilitystring
private — только ты; unlisted — все, у кого есть ссылка; public — ещё лента и профиль, нельзя вместе с oneTime (400 ONE_TIME_NOT_PUBLIC). Не передано при создании — настройка аккаунта; при изменении — доступ прежний.
значения: "private" "unlisted" "public"
ttlstring
Срок хранения от момента запроса: day, week, month или forever — без срока. После него ссылка перестаёт открываться, зашифрованные данные удаляются в фоне.
значения: "forever" "day" "week" "month"
passwordstringтолько в запросе
8–128 символов. Пустая строка снимает пароль, без поля пароль не меняется. Хранится как Argon2id и не возвращается; смена закрывает доступ тем, кто уже открывал. В ленте, профилях и альбомах другие видят такой файл закрытой карточкой.
не длиннее 128 · шаблон ^(?:[\s\S]{8,128})?$
oneTimeboolean
Файл откроет только первый гость — не дольше 10 минут, включая перемотку видео. Твой просмотр и запросы GET/HEAD ссылку не тратят. Нельзя вместе с public; в ленте, профилях и альбомах такой файл не показывается.
по умолчанию false
allowDownloadboolean
Показывать ли кнопку скачивания. Это не защита от копирования.
expiresAtstring · date-time
Pro, функция link_expiry: точный конец файла и ссылки — от 5 минут до 10 лет вперёд (иначе 400 LINK_EXPIRY_INVALID), вместо ttl; оба сразу — 400 VALIDATION_FAILED. В этот момент файл удаляется.
не длиннее 40
viewLimitintegerили null
Pro, функция view_limit: после стольких засчитанных просмотров ссылка отвечает как истёкшая. Лимит не выше уже набранных просмотров закрывает ссылку сразу; повышение или снятие (null, на любом тарифе) открывает снова.
1–1 000 000

Ответы

200ГотовоContent
- idstringобязательный
  id файла.
- titlestringобязательный
  Название.
- tagsмассив stringобязательный
  Теги.
  до 10 элементов · без повторов
- originalNamestring
  Исходное имя файла.
- typestringобязательный
  IMAGE, VIDEO, PASTE или FOLDER — папка с кодом.
  значения: "IMAGE" "VIDEO" "PASTE" "FOLDER"
- mimestringобязательный
  MIME-тип сохранённого файла.
- pasteFormatstringили null
  Формат заметки.
  значения: "plain" "markdown" "code"
- pasteLanguagestringили null
  Язык подсветки заметки.
- folderFilesintegerили null
  У папки с кодом — сколько в ней файлов; у остального null.
  от 1
- revisionintegerобязательный
  Ревизия текста заметки для правки.
  от 1
- accessVersionintegerобязательный
  Share access version: 1 for a new file, raised by every change of visibility, password or one-time. From 2 on, url carries it as ?v= so messengers build a fresh link card instead of the one they kept for the previous access.
  от 1
- sizeinteger · int64обязательный
  Размер в байтах.
- visibilitystringобязательный
  Доступ: private, unlisted или public.
  значения: "private" "unlisted" "public"
- allowDownloadbooleanобязательный
  Показывается ли кнопка скачивания.
- passwordProtectedbooleanобязательный
  Есть ли пароль.
- oneTimebooleanобязательный
  Одноразовая ли ссылка.
- consumedAtstring · date-timeили null
  Когда одноразовая ссылка была открыта.
- readExpiresAtstring · date-timeили null
  До какого момента открывший одноразовую ссылку может смотреть файл.
- readMaxExpiresAtstring · date-timeили null
  Самый поздний конец доступа по одноразовой ссылке.
- hasVideoTextboolean
  Есть ли у видео субтитры или расшифровка.
- videoTextRevisioninteger
  Ревизия текста видео.
  0–2 147 483 647
- viewsintegerобязательный
  Засчитанные открытия гостями, без повторов в пределах доступа зрителя (обычно сутки). Просмотры владельца не считаются.
  от 0
- viewLimitintegerили null
  Лимит просмотров (Pro) или null.
  1–1 000 000
- viewLimitReachedAtstring · date-timeили null
  Когда лимит просмотров исчерпан; null, пока просмотры есть или лимита нет.
- mediaStatusstring
  Обработка: PROCESSING — идёт, READY — готово, FAILED — не удалась. Воспроизведение и превью — после READY; оригинал владелец может скачать и раньше, с ?download=1.
  значения: "PROCESSING" "READY" "FAILED"
- mediaErrorstringили null
  Причина, если обработка не удалась.
- widthintegerили null
  Ширина в пикселях.
- heightintegerили null
  Высота в пикселях.
- durationMsintegerили null
  Длительность видео в миллисекундах.
- videoCodecstringили null
  Кодек видео.
- hasAudioboolean
  Есть ли звук.
- previewUrlstringили null
  Адрес зашифрованного превью; доступ — как у самого файла.
- expiresAtstring · date-timeили null
  Когда файл и ссылка перестанут работать; null — без срока.
- createdAtstring · date-timeобязательный
  Когда создан.
- urlstring · uriобязательный
  Ссылка на страницу файла.
- mediaUrlstringобязательный
  Адрес самого файла.
- moderationHoldstringили null
  Автопроверка: review — скрыт до решения модератора, blocked — скрыт модератором. Другие видят такой файл как приватный.
  значения: "review" "blocked"
- favoriteboolean
  В избранном (в списках).
- ownedboolean
  Свой файл (в списках).
- authorobject
  Автор.
  3 поля
  - idstring
    id автора.
  - usernamestring
    Никнейм.
  - namestring
    Имя.
400Некорректный запросLINK_EXPIRY_INVALID ONE_TIME_NOT_PUBLIC
401Нужен действующий ключ
403Нет права или функции тарифаPLAN_FEATURE_REQUIRED
404Не найдено
409Конфликт
410Файл удалён или истёк
413Слишком большой файл или нет места
429Слишком много запросов
503Сервис занят или недоступен

Пример ответа

200 · application/json

{
  "id": "Xq3u9RkT0bLmA7cV2pWz1eFy",
  "title": "capture",
  "tags": [
    "release"
  ],
  "originalName": "capture.png",
  "type": "IMAGE",
  "mime": "image/png",
  "pasteFormat": null,
  "pasteLanguage": null,
  "folderFiles": 1,
  "revision": 1,
  "accessVersion": 1,
  "size": 482133,
  "visibility": "unlisted",
  "allowDownload": true,
  "passwordProtected": false,
  "oneTime": false,
  "consumedAt": null,
  "readExpiresAt": null,
  "readMaxExpiresAt": null,
  "hasVideoText": false,
  "videoTextRevision": 0,
  "views": 3,
  "viewLimit": null,
  "viewLimitReachedAt": null,
  "mediaStatus": "READY",
  "mediaError": null,
  "width": 1920,
  "height": 1080,
  "durationMs": null,
  "videoCodec": null,
  "hasAudio": false,
  "previewUrl": null,
  "expiresAt": null,
  "createdAt": "2026-09-27T09:30:00.000Z",
  "url": "https://lac.pics/s/Xq3u9RkT0bLmA7cV2pWz1eFy",
  "mediaUrl": "/api/media/Xq3u9RkT0bLmA7cV2pWz1eFy",
  "moderationHold": null,
  "favorite": false,
  "owned": true,
  "author": {
    "id": "cmf8a1x2k0000q7lh3v9w2e4d",
    "username": "alex",
    "name": "Alex"
  }
}

Коды ошибок

Код	Статус	Текст
`LINK_EXPIRY_INVALID`	400	Выбери дату и время не раньше чем через 5 минут и не позже чем через 10 лет.
`ONE_TIME_NOT_PUBLIC`	400	Одноразовый файл нельзя опубликовать в ленте и профиле. Выбери доступ по ссылке или отключи одноразовую ссылку.
`PLAN_FEATURE_REQUIRED`	403	Это доступно в Pro.

Ответы любого метода с ключом — неверный или истёкший ключ, нет права, частые запросы — в разделе Ошибки.