Rob Zolkos
cdd13c1a61
* 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
66 lines
1.1 KiB
Markdown
66 lines
1.1 KiB
Markdown
# Account
|
|
|
|
## `GET /account/settings`
|
|
|
|
Returns the current account.
|
|
|
|
__Response:__
|
|
|
|
```json
|
|
{
|
|
"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:__
|
|
|
|
```json
|
|
{
|
|
"entropy": {
|
|
"auto_postpone_period_in_days": 30
|
|
}
|
|
}
|
|
```
|
|
|
|
__Response:__
|
|
|
|
Returns the account object:
|
|
|
|
```json
|
|
{
|
|
"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:__
|
|
|
|
```json
|
|
{
|
|
"board": {
|
|
"auto_postpone_period_in_days": 90
|
|
}
|
|
}
|
|
```
|
|
|
|
__Response:__
|
|
|
|
Returns the board object.
|