Skip to content
OpenTrain AIOpenTrain AIOpenTrain AIDocs

Ask OpenTrain

Answers from the documentation, with sources.

What would you like to do with OpenTrain?

AI answers can be mistaken. Check the linked sources. Don’t include private account information.

Open app

DEVELOPER DOCUMENTATION

Archive a Project To-do

Retire an item with an audited reason, closing its open assignments while retaining history.

Use with AI
View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in PerplexityAdd to CursorAdd to VS Code
POST/api/public/v1/project-todos/manage

Archives one item: it leaves the active catalog, future-hire auto-assignment turns off, and every open assignment closes with your reason recorded in each person’s history. Completed, waived, and already-closed history is retained. Requires project_todos:write and employer access to the job.

Preview first with preflight (operation: "archive_item") — it returns the exact number of open assignments that would close.

actionstringbodyrequired
archive_item
idempotencyKeystringbodyrequired
jobIdstringbodyrequired
itemIdstringbodyrequired
reasonstringbodyrequired

Audited and kept on every closed assignment (up to 2,000 characters).

Response

Section titled “Response”
{
  "ok": true,
  "action": "archive_item",
  "itemId": "…",
  "archive": {
    "closedAssignments": 2,
    "closedAssignmentIds": ["…", "…"],
    "irreversible": true,
    "historyRetained": true
  }
}

Archiving cannot be undone through this surface. To require the work again, create a new item.