Restore an archived project
Restore an archived project. Manager, Admin or Owner. Clears `deletedAt` and sets `status` from `ARCHIVED` back to `ACTIVE` (a project archived before status followed the archive keeps its `ACTIVE` or `COMPLETED`). Idempotent: an active project is returned unchanged with a warning. Does not restore the client (a warning says when it is archived). Plan: Studio or Agency (API access). Scope: write.
Authorization
BearerAuth Personal Access Token. Mint at Settings → API. Token shape: hsk_<env>_<prefix12>_<secret32>.
In: header
Path Parameters
Project UUID.
Header Parameters
Caller-generated UUID/ULID; replay returns the cached response within 24h.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/restore" \ -H "Idempotency-Key: string"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "orgId": "25b2c2d5-a7fc-47d0-89e4-8709a1560bfa", "clientId": "5e505642-9024-474d-9434-e5a44f505cc5", "name": "string", "description": "string", "color": "string", "status": "ACTIVE", "rateType": "HOURLY", "hourlyRate": "string", "fixedFeeAmount": "string", "fixedFeePriorInvoicedAmount": "string", "fixedFeeBillingInitializedAt": "2019-08-24T14:15:22Z", "budgetHours": "string", "budgetAmount": "string", "startDate": "2019-08-24", "dueDate": "2019-08-24", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "deletedAt": "2019-08-24T14:15:22Z" }, "warnings": [ "string" ]}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}Archive a project (soft delete)
Requires Manager, Admin, or Owner. Archives the project: sets `deletedAt` and `status: ARCHIVED`; tracked time and invoices stay. 422 when an active or needs-attention recurring invoice series uses the project as a source, or a fixed-fee project is reserved on a draft invoice. Undo with `POST /projects/{id}/restore`.
Preview what archiving a project affects
Manager, Admin or Owner (contains money). Read-only. Plan: Studio or Agency (API access). Scope: read.