# Presentation recorder (/ui/candidate-presentation-recorder)

## What it shows [#what-it-shows]

A short voice note to send with a profile.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `onAccept` (required) | `(blob: Blob, mimeType: string) => Promise<void>` | Called with each finished take, as soon as recording stops. Upload or save it here. While it runs the recorder shows `uploading`; if it throws, the take stays playable with Retry and Discard, and the error's message (or `labels.acceptFailed`) shows under the controls. |
| `externalState` | `CandidatePresentationRecorderState` | Shows `uploading` or `transcribing` from outside, such as while you transcribe an accepted take. Any other value leaves the recorder's own state showing. |
| `existingAudio` | `string \| null` | A recording already saved, playable until a new take is accepted. |
| `onPendingChange` | `(pending: boolean) => void` | Told whether a take is in progress or unsaved (requesting, recording, uploading, transcribing, or a take kept to retry), so you can hold off closing or sharing until it settles. |
| `disabled` | `boolean` | Disables starting, retrying and discarding. Stopping a recording stays possible. |
| `renderAudio` | `(audio: CandidatePresentationRecorderAudio) => ReactNode` | Renders a player. Defaults to the browser's own audio controls. |
| `labels` | `Partial<CandidatePresentationRecorderLabels>` |   |

## Data it needs [#data-it-needs]

The component takes plain values and callbacks and keeps no records of its own. Pass it yours, from the Kith data layer or from a backend you already run.

## Copy to your agent [#copy-to-your-agent]

```text title="Copy to your agent"
Install RecruiterOS/recruit-ui and add a voice note recorder to the dialog that shares a profile with a client.
```