> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qumo-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# client.identities

> Project-scoped machine identities and their authentication tokens.

Project-scoped machine identities and their authentication tokens.

Reach it as `client.identities` on a [`QumoClient`](/sdk/reference/client#qumoclient).

### list

```ts theme={null}
list(projectId: string): Promise<Identity[]>
```

Lists a project's machine identities.

Types: [`Identity`](/sdk/reference/types#identity)

### create

```ts theme={null}
create(projectId: string, name: string): Promise<Identity>
```

Creates a machine identity in a project.

Types: [`Identity`](/sdk/reference/types#identity)

### delete

```ts theme={null}
delete(projectId: string, id: string): Promise<void>
```

Deletes a machine identity and revokes its tokens.

### createToken

```ts theme={null}
createToken(projectId: string, id: string, scopes?: string[]): Promise<IdentityToken>
```

Creates a token for an identity. `scopes` defaults to all (`*`). The `value` is shown only once.

Types: [`IdentityToken`](/sdk/reference/types#identitytoken)

### listTokens

```ts theme={null}
listTokens(projectId: string, id: string): Promise<IdentityTokenMetadata[]>
```

Lists an identity's tokens, without their secrets.

Types: [`IdentityTokenMetadata`](/sdk/reference/types#identitytokenmetadata)

### revokeToken

```ts theme={null}
revokeToken(projectId: string, id: string, tokenId: string): Promise<void>
```

Revokes one of an identity's tokens.