---
title: "Archive Section"
method: POST
path: "/api/v1/sections/{section_id}/archive"
tags: ["Sections"]
---

# Archive Section

`POST /api/v1/sections/{section_id}/archive`

Marks a section as archived.

## Path parameters

- `section_id` string, required — String ID of the section

## Response `200`

Successful Response

- SectionSyncView — A class with fields representing a SectionView which will be returned to clients in a sync (or sync-like) response.
  - `id` string, required — String ID of the section.
  - `user_id` string, required — String ID of the user who owns the section.
  - `project_id` string, required — String ID of the project that contains the section.
  - `added_at` string, date-time, required — Date and time when the section was created.
  - `updated_at` string, date-time, nullable, required — Date and time when the section was last updated, or `null` if unknown.
  - `archived_at` string, date-time, nullable, required — Date and time when the section was archived, or `null` if it is active.
  - `name` string, required — Section name.
  - `description` string, nullable, required — Section description, or `null` if it has none.
  - `section_order` integer, required — Position of the section in the project.
  - `order_key` string, nullable, required — Fractional-indexing order key: sections sort by comparing keys lexicographically within a project. May be `null` for projects not yet migrated.
  - `is_collapsed` boolean, required — Whether the section is collapsed in the user's view.
  - `is_archived` boolean, required — Whether the section is archived.
  - `is_deleted` boolean, required — Whether the section is deleted.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)