---
title: "Archived Projects"
method: GET
path: "/api/v1/workspaces/{workspace_id}/projects/archived"
tags: ["Workspace"]
---

# Archived Projects

`GET /api/v1/workspaces/{workspace_id}/projects/archived`

Return archived projects in a workspace.

Workspace guests cannot list archived projects and receive a `FORBIDDEN`
error. Results are paginated by `cursor` and `limit`.

## Path parameters

- `workspace_id` integer, required — ID of the workspace whose archived projects should be listed.

## Query parameters

- `cursor` string, nullable — An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
- `limit` integer — The number of archived workspace projects to return in a page.

## Response `200`

Successful Response

- ProjectsResponse
  - `has_more` boolean, required — Whether another page of results is available.
  - `next_cursor` string — Cursor for the next page of results.
  - `workspace_projects` WorkspaceProjectView[], required — Workspace projects in the current page.
    - `initiated_by_uid` integer, required — Numeric ID of the user requesting the workspace project.
    - `project_id` string, required — String ID of the project.
    - `workspace_id` integer, required — Numeric ID of the workspace that contains the project.
    - `public_access` boolean, required — Whether the project is publicly accessible.
    - `access` ProjectAccessView, required — Contains the details on who can view a project.
      - `visibility` 'restricted' | 'team' | 'public', required — Indicates who can see a project
      - `configuration` union, required — Configuration for the selected visibility level.
        - RestrictedProjectConfiguration — Configuration specific to restricted projects.
        - TeamProjectConfiguration — Configuration specific to team projects.
        - PublicProjectConfiguration — Configuration specific to public projects.
          - `hide_collaborator_details` boolean, required — Whether collaborator details are hidden on the public project.
          - `disable_duplication` boolean, required — Whether public project duplication is disabled.
    - `folder_id` integer, nullable — Numeric ID of the folder that contains the project, or `null`.
    - `is_invite_only` boolean, nullable — Whether joining the workspace project requires an invitation.
    - `is_archived` boolean — Whether the workspace project is archived.
    - `archived_timestamp` integer — Unix timestamp for when the project was archived, or 0 if active.
    - `archived_date` string, date-time, nullable — Date and time when the project was archived, or `null` if active.
    - `is_frozen` boolean — Whether the project is frozen and cannot be modified.
    - `name` string — Project name.
    - `color` integer, nullable — Numeric project color code.
    - `view_style` 'LIST' | 'BOARD' | 'CALENDAR'
    - `description` string — Project description.
    - `status` 'PLANNED' | 'IN_PROGRESS' | 'PAUSED' | 'COMPLETED' | 'CANCELED' — Project status. At the moment, this is for workspace projects only.
    - `default_order` integer — Default order of the project in workspace views.
    - `is_project_insights_enabled` boolean — Whether project insights are enabled for the project.
    - `_role` 'CREATOR' | 'ADMIN' | 'READ_WRITE' | 'EDIT_ONLY' | 'COMPLETE_ONLY' — User role in the project. For personal project the role should be always "CREATOR" User role for projects v1 maybe specified as "CREATOR" or "ADMIN", because in the past there was no permissions.

## 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)