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

# ISupportsPrincipalWrites

> Creates and updates principals in a target.

```csharp
public interface ISupportsPrincipalWrites
```

## Methods

### CreatePrincipalAsync()

```csharp
Task<WriteOutcome> CreatePrincipalAsync(ConnectionContext context, DesiredPrincipal desired, CancellationToken cancellationToken)
```

Creates a principal, touching nothing the vendor already holds.

#### Parameters

**context** `ConnectionContext` *required*

**desired** `DesiredPrincipal` *required*

**cancellationToken** `CancellationToken` *required*

#### Returns

`Task<WriteOutcome>`

### UpdatePrincipalAsync()

```csharp
Task<WriteOutcome> UpdatePrincipalAsync(ConnectionContext context, string id, DesiredPrincipal desired, CancellationToken cancellationToken)
```

Updates an existing principal.

#### Parameters

**context** `ConnectionContext` *required*

**id** `string` *required*

**desired** `DesiredPrincipal` *required*

**cancellationToken** `CancellationToken` *required*

#### Returns

`Task<WriteOutcome>`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.