Files
fizzy/docs/api/sections/account.md
T
Rob Zolkos cdd13c1a61 Split API docs into per-resource sections under docs/api/ (#2793)
* Split docs/API.md into per-resource sections under docs/api/

* Move API endpoints index above authentication in docs/api/README.md

* Fix trailing comma in boards.md JSON example

* Fix trailing comma in cards.md, add Response label to identity.md, add Rich Text to endpoint index
2026-04-06 14:00:17 -04:00

1.1 KiB

Account

GET /account/settings

Returns the current account.

Response:

{
  "id": "03f5v9zjvypwh0t0e2rfh0h7k",
  "name": "37signals",
  "cards_count": 5,
  "created_at": "2025-12-05T19:36:35.401Z",
  "auto_postpone_period_in_days": 30
}

The auto_postpone_period_in_days is the account-level default in days (e.g. 30). Cards are automatically moved to "Not Now" after this period of inactivity. Each board can override this with its own value.

PUT /account/entropy

Updates the account-level default auto close period. Requires admin role.

Request:

{
  "entropy": {
    "auto_postpone_period_in_days": 30
  }
}

Response:

Returns the account object:

{
  "id": "03f5v9zjvypwh0t0e2rfh0h7k",
  "name": "37signals",
  "cards_count": 5,
  "created_at": "2025-12-05T19:36:35.401Z",
  "auto_postpone_period_in_days": 30
}

PUT /:account_slug/boards/:board_id/entropy

Updates the auto close period for a specific board. Requires board admin permission.

Request:

{
  "board": {
    "auto_postpone_period_in_days": 90
  }
}

Response:

Returns the board object.