# User (/sdk/reference/user)



{/* Generated by docs-site/scripts/generate-sdk-docs.ts — do not edit. */}

### `createApiToken` [#createapitoken]

`POST /api/v0/user/api-tokens`

Create a personal API key

Returns the raw secret in the response body. It is shown only once and cannot be retrieved later.

```ts
import { createApiToken } from "@harmont/cloud";
```

```ts
createApiToken(options): RequestResult<CreateApiTokenResponse>
```

**Body** `ApiTokenCreateRequest` (optional)

**Returns** `CreateApiTokenResponse`

See [`POST /api/v0/user/api-tokens`](/api/reference/user) for the full request and response schema.

### `deleteCurrentUser` [#deletecurrentuser]

`DELETE /api/v0/user`

Delete the current user's account

```ts
import { deleteCurrentUser } from "@harmont/cloud";
```

```ts
deleteCurrentUser(options): RequestResult<DeleteCurrentUserResponse>
```

**Returns** `DeleteCurrentUserResponse`

See [`DELETE /api/v0/user`](/api/reference/user) for the full request and response schema.

### `getCurrentUser` [#getcurrentuser]

`GET /api/v0/user`

Get the current authenticated user

Returns the bearer-authenticated user and their personal-organization slug.

```ts
import { getCurrentUser } from "@harmont/cloud";
```

```ts
getCurrentUser(options): RequestResult<GetCurrentUserResponse>
```

**Returns** `GetCurrentUserResponse`

See [`GET /api/v0/user`](/api/reference/user) for the full request and response schema.

### `listApiTokens` [#listapitokens]

`GET /api/v0/user/api-tokens`

List the current user's API keys

```ts
import { listApiTokens } from "@harmont/cloud";
```

```ts
listApiTokens(options): RequestResult<ListApiTokensResponse>
```

**Returns** `ListApiTokensResponse`

See [`GET /api/v0/user/api-tokens`](/api/reference/user) for the full request and response schema.

### `revokeApiToken` [#revokeapitoken]

`DELETE /api/v0/user/api-tokens/{id}`

Revoke one of the current user's API keys

```ts
import { revokeApiToken } from "@harmont/cloud";
```

```ts
revokeApiToken(options): RequestResult<RevokeApiTokenResponse>
```

| Parameter | In   | Type     | Description     |
| --------- | ---- | -------- | --------------- |
| `id`      | path | `string` | The API key id. |

**Returns** `RevokeApiTokenResponse`

See [`DELETE /api/v0/user/api-tokens/{id}`](/api/reference/user) for the full request and response schema.

### `updateCurrentUser` [#updatecurrentuser]

`PATCH /api/v0/user`

Update the current user's display name

```ts
import { updateCurrentUser } from "@harmont/cloud";
```

```ts
updateCurrentUser(options): RequestResult<UpdateCurrentUserResponse>
```

**Body** `UserUpdateRequest` (optional)

**Returns** `UpdateCurrentUserResponse`

See [`PATCH /api/v0/user`](/api/reference/user) for the full request and response schema.