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

# appProcess.current.requestClose

API reference for the appProcess.current.requestClose method.

Requests the termination of the current process.

Once called, this method:

1. Transitions the state of the process to `"closing"`.
2. Invokes all registered `setOnDispose` callbacks.
3. Waits for the process to finish closing.
4. Transitions the state of the process to `"closed"`.

Each time the state changes, all of the `registerOnStateChange` callbacks are called.

## Usage

### Close current process

```typescript
import { appProcess } from '@canva/platform';

await appProcess.current.requestClose({ reason: 'completed' });
```

### Pass structured data to current process as it closes

```typescript
import { appProcess, type CloseParams } from '@canva/platform';

type DetailedCloseParams = CloseParams & {
  metadata: {
    savePoint: string;
    timestamp: number;
    userInitiated: boolean;
  }
};

await appProcess.current.requestClose<DetailedCloseParams>({
  reason: 'completed',
  metadata: {
    savePoint: 'auto_backup_1',
    timestamp: Date.now(),
    userInitiated: true
  }
});
```

## Parameters

<Prop.List>
  <Prop name="params" required type="T" sourceLineNumbers={[339]}>
    Parameters to pass to the `setOnDispose` callback. Any structured data can be passed via this property.

    <PillAccordion defaultExpanded={true} title={<>Properties of <strong>params</strong></>}>
      <Prop.List>
        <Prop name="reason" required type="CloseReason" sourceLineNumbers={[231]}>
          The reason the app process is closing.

          <Prop.Extras>
            **Available values**:

            * `"completed"`
            * `"aborted"`
          </Prop.Extras>
        </Prop>
      </Prop.List>
    </PillAccordion>
  </Prop>
</Prop.List>

## Returns

`Promise<void>`