API-пайплайн: архивировать, вернуть или удалить свои карточки
Индекс: API-пайплайны — индекс
Цель: убрать с глаз карточки, которые больше не нужны, вернуть их или удалить навсегда.
Шаги
- В архив.
POST /v0/my/archive
{"nonce": "470000000000000001", "archived": true}
→ {"nonce": "470000000000000001", "archived": true}
Работает для любой карточки, которую вы можете редактировать (вы владелец или у вас есть write).
Архивные карточки:
GET /v0/my/{projects|articles|posts|docs|sheets|boards|workspaces|campaigns|oracles|agendas|api_endpoints|secrets|links|telegram_groups|rubrics|coupons}?archived=true. Безarchived=trueэти списки архивные карточки не показывают.Вернуть из архива: тот же вызов с
"archived": false.Удалить.
DELETE /v0/my/projects/470000000000000001
→ {"success": true}
Также для articles, posts, docs, sheets, boards, workspaces, campaigns, oracles, agendas, api_endpoints, secrets, links, rubrics, coupons.
За кадром
- Архив больше ничего не меняет: у карточки остаются видимость, ссылки, гранты и история.
- Удаление окончательное, отменить его нельзя: карточка удаляется вместе с местами в воркспейсах, выданным на неё доступом и лайками. Если сомневаетесь, отправьте в архив.
- Перед удалением остановите запущенную кампанию или оракула.
Правила
- 404: не найдена или вам нельзя её менять.
- Возврат из архива: 400
version snapshots and history workspaces stay archived. API-пайплайн: история версий карточки
Поверхность API
| Эндпоинт | Назначение | FE | ИИ / оракул |
|---|---|---|---|
POST /v0/my/archive |
В архив или из архива | да (В архив, Вернуть из архива) | да |
GET /v0/my/<type>s?archived=true |
Список архивных карточек | да (Архив) | да |
DELETE /v0/my/<type>s/{nonce} |
Удалить карточку навсегда | да (Удалить) | только по явной просьбе владельца |