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

# recording-requests

> Ask someone to record a video and get back a link to send them.

A recording request creates an empty recording in the workspace along with a
URL the recipient opens to record and upload their video. For fields and
response details, see the
[API reference](/api-reference/recording-requests/create).

<Info>
  Sample output on this page is the JSON envelope you get with `--json`. On a
  terminal the same data prints as a table or a key-value list. See
  [Output formats](/cli/output-formats).
</Info>

## recording-requests create

Creates a request and returns the URL to share with whoever will record it.

```bash theme={"system"}
neetorecord recording-requests create \
  --title "Walk me through the billing bug" \
  --created-by-email oliver@example.com \
  --request-instructions "Start from the invoice list and reproduce the error." \
  --request-notes "Raised by support ticket 4821."
```

| Flag                     | Type     | Required | Default | Description                                                    |
| ------------------------ | -------- | -------- | ------- | -------------------------------------------------------------- |
| `--created-by-email`     | `string` | Yes      |         | Email of the recording requester                               |
| `--request-instructions` | `string` |          |         | Instructions shown to the person who will upload the recording |
| `--request-notes`        | `string` |          |         | Private notes for this request                                 |
| `--title`                | `string` | Yes      |         | Title of the requested recording                               |

`--created-by-email` must be the email of an active member of the workspace.
That person is recorded as the requester, and the request counts against their
monthly recording limit.

```json theme={"system"}
{
  "data": {
    "recording_request": {
      "id": "7d2e5b90-1c34-4a68-b7f5-9e0a2c3d4b18",
      "title": "Walk me through the billing bug",
      "request_url": "https://acme.neetorecord.com/request/7d2e5b90-1c34-4a68-b7f5-9e0a2c3d4b18",
      "created_at": "2025-07-14T08:31:47.000Z"
    }
  }
}
```

`--request-instructions` is shown to the person who opens the link.
`--request-notes` is private to the workspace.