# Accounts

Resolve the API key account and read or update account metadata.

| Method | Operation | Path |
| --- | --- | --- |
| **`GET`** | [Get current account](#get-current-account) | `/v0/accounts/current` |
| **`GET`** | [Get an account](#get-an-account) | `/v0/accounts/:accountId` |
| **`POST`** | [Update an account](#update-an-account) | `/v0/accounts/:accountId` |

## Get current account

Resolve the account that owns the current API key.

**`GET`** `/v0/accounts/current`

- **API key permission:** Read-only or Read/write

### Request

~~~sh
curl \
  "https://api.interfold.dev/v0/accounts/current" \
  -H "Authorization: Bearer $INTERFOLD_API_KEY"
~~~

### Response

~~~json
{
  "id": "<account-id>",
  "name": "Acme"
}
~~~

### Behavior and errors

- This operation requires API key authentication.

### Related interfaces

- **CLI:** `interfold accounts current`

See [Errors](/api-reference/errors) for the standard error envelope and
[Authentication](/api-reference/authentication) for API key handling.

---

## Get an account

Read an account that the authenticated caller can access.

**`GET`** `/v0/accounts/:accountId`

- **API key permission:** Read-only or Read/write

### Parameters

- `accountId` — account UUID.

### Request

~~~sh
curl \
  "https://api.interfold.dev/v0/accounts/<account-id>" \
  -H "Authorization: Bearer $INTERFOLD_API_KEY"
~~~

### Response

~~~json
{
  "id": "<account-id>",
  "name": "Acme"
}
~~~

See [Errors](/api-reference/errors) for the standard error envelope and
[Authentication](/api-reference/authentication) for API key handling.

---

## Update an account

Change the account name.

**`POST`** `/v0/accounts/:accountId`

- **API key permission:** Read/write

### Parameters

- `accountId` — account UUID.
- `name` — required string, 1–100 characters after trimming.

### Request

~~~sh
curl -X POST \
  "https://api.interfold.dev/v0/accounts/<account-id>" \
  -H "Authorization: Bearer $INTERFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{  "name": "Acme Studio"}'
~~~

### Response

~~~json
{
  "id": "<account-id>",
  "name": "Acme Studio"
}
~~~

### Behavior and errors

- Only account administrators can update an account.

See [Errors](/api-reference/errors) for the standard error envelope and
[Authentication](/api-reference/authentication) for API key handling.

## Shared behavior

All operations use the [API authentication](/api-reference/authentication),
[error](/api-reference/errors), and [rate-limit](/api-reference/rate-limits)
contracts. List operations use [standard pagination](/api-reference/pagination)
unless the operation says otherwise.