Call the account something else (doc/launch.md, 2.4)

This page as Markdown, or in an AI chatMore ways to read this page

Call the account something else (doc/launch.md, 2.4). Owners only.

# Call the account something else (doc/launch.md, 2.4)

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/patch-account

`PATCH /api/v1/account`

Call the account something else (doc/launch.md, 2.4). Owners only.

## What to send

`AccountRename`: What an account is called (doc/launch.md, 2.4).

- `name` (string, needed)

## The answer

200, `AccountView`: What an account is, to its members.

- `delete_days` (integer, needed): How many days an owner's own wish to delete waits.
- `deletion` (Deletion or null)
- `id` (string, needed)
- `instance` (boolean): The account of whoever runs this tidekeeper. It is not deleted from here: it goes when the instance does.
- `name` (string, needed)
- `pending` (boolean): It is new and waits for whoever runs this tidekeeper to approve it: nothing is counted until then.
- `suspended` (Suspended or null)

## Asking

```sh
curl -X PATCH https://tidekeeper.eu/api/v1/account \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"name": "…"}'
```

What to send

AccountRename What an account is called (doc/launch.md, 2.4).

name: stringneeded

The answer

Status 200

AccountView What an account is, to its members.

delete_days: integerneededHow many days an owner's own wish to delete waits.
deletion: Deletion or null
id: stringneeded
instance: booleanThe account of whoever runs this tidekeeper. It is not deleted from here: it goes when the instance does.
name: stringneeded
pending: booleanIt is new and waits for whoever runs this tidekeeper to approve it: nothing is counted until then.
suspended: Suspended or null

Asking

curlJavaScript

With your token from Settings

curl -X PATCH https://tidekeeper.eu/api/v1/account \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"name": "…"}'

With your token from Settings

const answer = await fetch("https://tidekeeper.eu/api/v1/account", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"name": "…"}),
}).then((r) => r.json());