Accounts

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

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

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

Response

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

Behavior and errors

• This operation requires API key authentication.

Related interfaces

• CLI: interfold accounts current

See Errors for the standard error envelope and 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

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

Response

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

See Errors for the standard error envelope and 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

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

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

Behavior and errors

• Only account administrators can update an account.

See Errors for the standard error envelope and Authentication for API key handling.

Shared behavior

All operations use the API authentication, error, and rate-limit contracts. List operations use standard pagination unless the operation says otherwise.