> ISPO SDK documentation. [HTML](https://ispo.ai/docs/interfaces/core.UiApi.html) · [Documentation index](https://ispo.ai/docs/llms.txt)

# Interface UiApi

```typescript
interface UiApi {
    surfaces: ProjectSurfacesApi;
    notify(input: NotifyInput): Promise<void>;
    onNotificationClick(handler: NotificationClickHandler): () => void;
}
```

Types: [surfaces](#surfaces), [ProjectSurfacesApi](core.ProjectSurfacesApi.md), [notify](#notify-1), [NotifyInput](core.NotifyInput.md), [onNotificationClick](#onnotificationclick-1), [NotificationClickHandler](../types/core.NotificationClickHandler.md)

##### Index

### <a id="properties"></a>Properties

[surfaces](#surfaces)

### <a id="methods"></a>Methods

[notify](#notify) [onNotificationClick](#onnotificationclick)

## <a id="properties-1"></a>Properties

### <a id="surfaces"></a>surfaces

```typescript
surfaces: ProjectSurfacesApi
```

Types: [ProjectSurfacesApi](core.ProjectSurfacesApi.md)

## <a id="methods-1"></a>Methods

### <a id="notify"></a>notify

*   <a id="notify-1"></a>
    
    ```typescript
    notify(input: NotifyInput): Promise<void>
    ```
    
    Types: [NotifyInput](core.NotifyInput.md)
    
    #### Parameters
    
    *   input: [NotifyInput](core.NotifyInput.md)
    
    #### Returns Promise<void\>
    

**Authority for `ui.notify`**

Reviewed request token: `ui.notify`. Standing capability: `ui.notify`.

Handle structured `ProjectRpcError` failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. [Method authority and recovery](/docs/documents/Method_authority.md).

### <a id="onnotificationclick"></a>onNotificationClick

*   <a id="onnotificationclick-1"></a>
    
    ```typescript
    onNotificationClick(handler: NotificationClickHandler): () => void
    ```
    
    Types: [NotificationClickHandler](../types/core.NotificationClickHandler.md)
    
    #### Parameters
    
    *   handler: [NotificationClickHandler](../types/core.NotificationClickHandler.md)
    
    #### Returns () \=> void