# record.missing

The thing does not exist, or the caller may not know it does

Profile: [Errors](https://www.prongs.dev/docs/intents/errors.md) · Raised with: [`fail()`](https://www.prongs.dev/docs/profiles/errors.md) · Status: `404` · Message: yours

## Example

```ts
return fail('record.missing', 'Profile not found.');
```

The caller gets

```bash
HTTP 404

{
  "ok": false,
  "error": "Profile not found.",
  "code": "record.missing"
}
```

## Choosing between neighbours

Find the row that describes your case, and use the intent on the right.

| If it is for… | Use |
|---|---|
| The thing does not exist, or the caller may not know it does | `record.missing` (this page) |
| A record that does not exist (rather than [`request.missing`](https://www.prongs.dev/docs/intents/request/missing.md)) | `record.missing` (this page) |
| Hiding that the thing exists at all (rather than [`permission.denied`](https://www.prongs.dev/docs/intents/permission/denied.md)) | `record.missing` (this page) |

## Connections

Declared in the registry, both directions. Where an intent is used in your own code is something check and the gallery see; this site has no app code.

- Built from: [`status.notfound`](https://www.prongs.dev/docs/intents/errors.md#status-notfound)

## For registry authors

**Starter intents.** These are the intents `prongs add errors` puts in your registry, raised with [`fail()`](https://www.prongs.dev/docs/profiles/errors.md). Change the messages to suit your app, and the statuses through the [`status.*`](https://www.prongs.dev/docs/intents/errors.md#status) intents they are built from.

The entry `prongs add errors` writes into your registry. Change the message here, or the status through its [`status.*`](https://www.prongs.dev/docs/intents/errors.md#status) ref.

```ts
'record.missing': {
  kind: 'semantic',
  description: 'The thing does not exist, or the caller may not know it does',
  refs: ['status.notfound'],
  keywords: ['not found', 'missing', 'unknown', 'no such'],
  binding: { publicMessage: 'Not found.' },
},
```
