From 66702573c860b834e6830db835af08f8d7d72590 Mon Sep 17 00:00:00 2001 From: Jeremy Daer Date: Wed, 5 Aug 2026 09:11:25 -0700 Subject: [PATCH] Document archiving and unarchiving a project --- sections/projects.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/sections/projects.md b/sections/projects.md index fde481f..e67b211 100644 --- a/sections/projects.md +++ b/sections/projects.md @@ -7,6 +7,8 @@ Endpoints: - [Get a project](#get-a-project) - [Create a project](#create-a-project) - [Update a project](#update-a-project) +- [Archive a project](#archive-a-project) +- [Unarchive a project](#unarchive-a-project) - [Trash a project](#trash-a-project) Get all projects @@ -559,6 +561,36 @@ curl -s -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/j ``` +Archive a project +------------------ + +* `PUT /projects/1/status/archived.json` will mark the project with the given ID as archived. + +No parameters required. Returns `204 No Content` if successful. On accounts where archiving and trashing projects is limited to admins and the project's creator, everyone else gets a `403 Forbidden`. + +###### Copy as cURL + +```shell +curl -s -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" -X PUT \ + https://3.basecampapi.com/$ACCOUNT_ID/projects/2085958507/status/archived.json +``` + + +Unarchive a project +-------------------- + +* `PUT /projects/1/status/active.json` will mark the project with the given ID as active, restoring it from either the archive or the trash. + +No parameters required. Returns `204 No Content` if successful. If the account has reached its project limit you'll see a `507 Insufficient Storage` and the same response documented under [Create a project](#create-a-project); the project stays where it is until the subscription is upgraded. + +###### Copy as cURL + +```shell +curl -s -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" -X PUT \ + https://3.basecampapi.com/$ACCOUNT_ID/projects/2085958507/status/active.json +``` + + Trash a project ----------------