Recordings

A recording is the core NeetoRecord resource. For fields and response details, see the API reference. Every command below takes the recording as a positional argument. That argument accepts either the recording’s id or its public_link_id, which is the last segment of a watch URL such as https://acme.neetorecord.com/watch/4f9c2a1b7e5d3086af12.

List recordings

This command lists the uploaded recordings you can see, newest first. Use this to find a recording id to pass to the other commands. Narrow the list with the filter flags, and use --sort-by and --sort-direction to change the order.

neetorecord recordings list --page 1 --page-size 30

To list the recordings you made in a week, filter by owner and created date. me means the signed-in member, and both dates are inclusive.

neetorecord recordings list --owner-email me --from-date 2026-10-05 --to-date 2026-10-11

To find recordings that still need a transcript, use --has-transcript=false. Repeat --tag to match any of several tags.

neetorecord recordings list --has-transcript=false --tag demo --tag onboarding

Flag	Type	Default	Description
`--folder-id`	`string`		Only recordings in this folder
`--from-date`	`string`		Created on or after (YYYY-MM-DD or YYYY-MM)
`--has-transcript`	`bool`	`false`	Only recordings with a transcript (use =false for those without)
`--owner-email`	`string`		Only recordings owned by this email, or ‘me’
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--requested-only`	`bool`	`false`	Only recording requests
`--sort-by`	`string`		Sort by created_at, title, duration or view_count
`--sort-direction`	`string`		Sort direction: asc or desc
`--tag`	`stringArray`	`[]`	Tag name (repeatable; matches any)
`--title`	`string`		Partial title match
`--to-date`	`string`		Created on or before (YYYY-MM-DD or YYYY-MM)

Sample output (--json)

{
  "data": [
    {
      "id": "3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d",
      "title": "Sprint demo",
      "default_title": "Recording on 12 Jul 2025",
      "duration": 412.5,
      "view_count": 24,
      "is_uploaded": true,
      "requested": false,
      "summary": "Walkthrough of the new folders view.",
      "public_link_id": "4f9c2a1b7e5d3086af12",
      "created_at": "2025-07-12T09:14:22.000Z",
      "updated_at": "2025-07-12T10:02:41.000Z",
      "uploaded_at": "2025-07-12T09:21:05.000Z",
      "public_url": "https://acme.neetorecord.com/watch/4f9c2a1b7e5d3086af12",
      "transcoded_url": "https://cdn.neetorecord.com/transcoded/4f9c2a1b7e5d3086af12/index.m3u8",
      "thumbnail_url": "https://cdn.neetorecord.com/thumbnails/4f9c2a1b7e5d3086af12.jpg",
      "user_name": "Oliver Smith",
      "tags": [
        {
          "id": "b21f7c90-4d3e-4a15-9c68-0f2e8b7a6d54",
          "name": "demo",
          "style": "secondary"
        }
      ],
      "folder_name": "Product demos",
      "folder_id": "8c1d4e77-2b3a-4f56-9e08-7d5c6b4a3f21",
      "has_transcript": true
    }
  ],
  "breadcrumbs": [
    { "label": "Show", "command": "neetorecord recordings show <id>" }
  ],
  "pagination": {
    "total_records": 95,
    "total_pages": 4,
    "current_page_number": 1,
    "page_size": 30
  }
}

Show a recording

This command shows one recording in full.

neetorecord recordings show 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

The output is the same recording object that list returns, wrapped in data with no pagination block.

Search recordings by title

This command searches recordings by title. Use this when you know roughly what a recording is called but not its id.

neetorecord recordings search --query "sprint"

Flag	Type	Required	Default	Description
`--page`	`int`		`0`	Page number
`--page-size`	`int`		`0`	Items per page (max 100)
`--query`	`string`	Yes		Title search query

The output matches recordings list.

Search recordings by transcript

This command searches the text of recording transcripts. Use this to find the recording where something was said, rather than one whose title matches.

neetorecord recordings search-by-transcript --query "pricing page"

Flag	Type	Required	Default	Description
`--page`	`int`		`0`	Page number
`--page-size`	`int`		`0`	Items per page (max 100)
`--query`	`string`	Yes		Text to search in transcripts

The output matches recordings list.

Upload a video

This command uploads an MP4 file as a new recording. It reserves the recording, sends the file to storage, and then starts processing. The file must be an .mp4 of up to 2 GB, and your plan must allow uploads. The command stops before it sends anything if the file is missing, is not an .mp4, or is over 2 GB. It retries network errors, timeouts, and 408, 429, and 5xx responses up to 3 times.

neetorecord recordings upload ./demo.mp4 --title "Quarterly product demo"

Required arguments:

<file.mp4> - the path to the video file.

Flag	Type	Required	Default	Description
`--folder-id`	`string`			Folder ID to put the recording in
`--title`	`string`			Title for the recording

Sample output (--json)

{
  "data": {
    "recording": {
      "id": "3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d",
      "title": "Quarterly product demo",
      "url": "https://acme.neetorecord.com/watch/4f9c2a1b7e5d3086af12"
    }
  },
  "breadcrumbs": [
    {
      "label": "Show",
      "command": "neetorecord recordings show <id>"
    }
  ]
}

Use --quiet to print only the recording id. The recording is processed in the background, so its watch page may take a short while to play.

Update a recording

This command renames a recording, replaces its summary, moves it between folders, or replaces its tags. Only the flags you pass are changed.

neetorecord recordings update 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d \
  --title "Sprint demo, July" \
  --tag demo --tag internal

Required arguments:

<id> - the recording id or public link id.

Flag	Type	Default	Description
`--folder-id`	`string`		Folder ID to move to (empty to remove from folder)
`--summary`	`string`		New summary
`--tag`	`stringArray`	`[]`	Tag name (repeatable; replaces all existing tags)
`--title`	`string`		New title

--tag replaces every tag on the recording, so pass the complete list each time. Tags that do not exist yet are created. Passing --folder-id "" removes the recording from its folder. --folder-id accepts the id returned by folders list. The output is the updated recording object, wrapped in data.

Delete a recording

This command deletes a recording and everything derived from it. This cannot be undone.

neetorecord recordings delete 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output

Recording deleted.

Show a transcript

This command prints the full transcript with its timestamped segments.

neetorecord recordings transcript 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "transcript": {
      "text": "Let me walk through the new folders view.",
      "segments": [
        {
          "start": 0.0,
          "end": 3.4,
          "text": "Let me walk through the new folders view."
        }
      ]
    }
  }
}

Check transcript status

This command reports whether a transcript exists and where generation has got to. Check this before polling for transcript text.

neetorecord recordings transcript-status 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "success",
    "has_transcript": true
  }
}

Generate a transcript

This command starts transcript generation, or regenerates an existing transcript in another language. Generation runs in the background.

neetorecord recordings trigger-transcript 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d --language en

Required arguments:

<id> - the recording id or public link id.

Flag	Type	Required	Default	Description
`--language`	`string`			Language code (e.g. ‘en’)

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "triggered"
  }
}

Show chapters

This command prints the auto-generated chapters of a recording.

neetorecord recordings chapters 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "chapters": [
      { "title": "Intro", "start": 0 },
      { "title": "Folders view", "start": 48 }
    ]
  }
}

Check chapter status

This command reports whether chapters exist and where generation has got to.

neetorecord recordings chapter-status 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "success",
    "has_chapters": true
  }
}

Generate chapters

This command starts chapter generation for a recording. It needs a transcript, so run trigger-transcript first if the recording does not have one.

neetorecord recordings trigger-chapters 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "triggered"
  }
}

This command prints the public watch link, and whether that link has expired or is behind access control.

neetorecord recordings share-link 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "public_url": "https://acme.neetorecord.com/watch/4f9c2a1b7e5d3086af12",
    "is_expired": false,
    "access_control_protected": false
  }
}

Get the embed code

This command prints the iframe snippet for embedding a recording in another page.

neetorecord recordings embed-code 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "embed_url": "https://acme.neetorecord.com/embeds/3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d",
    "embed_html": "<iframe src=\"https://acme.neetorecord.com/embeds/3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d\" width=\"100%\" height=\"480\" frameborder=\"0\" allowfullscreen></iframe>"
  }
}

Get the download URL

This command returns a presigned URL for downloading the recording. The URL is short lived, so fetch it right before you use it.

neetorecord recordings download-url 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d --format mp4

Required arguments:

<id> - the recording id or public link id.

Flag	Type	Required	Default	Description
`--format`	`string`		`mp4`	Download format: ‘mp4’ or ‘webm’

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "file_format": "mp4",
    "is_download_file_ready": true,
    "download_url": "https://cdn.neetorecord.com/downloads/4f9c2a1b7e5d3086af12.mp4?Expires=1752312000",
    "url_expires_in_seconds": 600
  }
}

When the MP4 has not been prepared yet, the response carries "is_download_file_ready": false and no URL. Run trigger-mp4, then try again. An MP4 URL is valid for 600 seconds; a --format webm URL is valid for 60 seconds and is ready as soon as the recording has been uploaded.

Generate the MP4

This command starts preparing the downloadable MP4 for a recording. Run it when download-url reports that the file is not ready.

neetorecord recordings trigger-mp4 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "generating"
  }
}

status is generating when regeneration was queued, already_generating when a conversion is already running, and ready when the MP4 is already up to date.

Get a screenshot

This command returns a URL to a still frame captured at a timestamp. Use this to pull a thumbnail out of a recording, or to look at what was on screen when something was said.

neetorecord recordings screenshot 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d \
  --timestamp 48.5 --format png

Required arguments:

<id> - the recording id or public link id.

Flag	Type	Required	Default	Description
`--format`	`string`		`png`	Image format: ‘png’ or ‘jpeg’
`--timestamp`	`float64`	Yes	`0`	Timestamp in seconds of the frame to capture

--timestamp must fall within the recording’s duration.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "timestamp": 48.5,
    "image_format": "png",
    "is_screenshot_ready": true,
    "screenshot_url": "https://cdn.neetorecord.com/screenshots/4f9c2a1b7e5d3086af12-48.5.png?Expires=1752312000",
    "url_expires_in_seconds": 600
  }
}

Show recording analytics

This command reports the view count for a single recording, broken down by day.

neetorecord recordings analytics 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "total_views": 24,
    "views_by_day": [
      { "date": "2025-07-12", "count": 9 },
      { "date": "2025-07-13", "count": 15 }
    ]
  }
}

For workspace-wide numbers, see analytics show.

List CTAs

This command lists the call-to-action buttons configured on a recording.

neetorecord recordings ctas 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d --sort-by start --sort-direction asc

Flag	Type	Default	Description
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--sort-by`	`string`		Sort by created_at, start or label
`--sort-direction`	`string`		Sort direction: asc or desc

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "ctas": [
      {
        "id": "c47e2f81-6a90-4b3d-8e21-5f0c9d7b1a63",
        "label": "Book a demo",
        "link": "https://acme.neetocal.com/meeting-with-oliver",
        "start": 30.0,
        "end": 90.0,
        "position": "top-right",
        "background_color": "#000000",
        "text_color": "#FFFFFF",
        "show_only_at_end": false
      }
    ]
  },
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}

Show action items

This command shows the action items extracted from a recording’s transcript, each with the second at which it was mentioned. Check status first: success, no_transcript, in_progress, failed or not_generated. The items are listed only when the status is success.

neetorecord recordings action-items 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "success",
    "action_items": [
      {
        "id": "9b1f3c52-7d84-4e0a-a6c1-2f5d8e7b3a90",
        "text": "Finalize the single sign-on pricing page",
        "start": 125.0
      }
    ]
  },
  "breadcrumbs": [
    { "label": "Trigger", "command": "neetorecord recordings trigger-action-items <id>" }
  ]
}

Generate action items

This command starts action item extraction. The transcript is sent to OpenAI and the items are produced in the background, so the command returns at once. Run recordings action-items until the status is success or failed. If the status is already success, no_transcript or in_progress, it is returned unchanged and nothing new starts.

neetorecord recordings trigger-action-items 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d

Required arguments:

<id> - the recording id or public link id.

Sample output (--json)

{
  "data": {
    "recording_id": "4f9c2a1b7e5d3086af12",
    "status": "in_progress",
    "action_items": []
  }
}

Create a CTA

This command adds a call-to-action button that appears over the video for a time range.

neetorecord recordings create-cta 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d \
  --label "Book a demo" \
  --link "https://acme.neetocal.com/meeting-with-oliver" \
  --start 30 --end 90 --position bottom-right

Required arguments:

<id> - the recording id or public link id.

Flag	Type	Required	Default	Description
`--background-color`	`string`		`#000000`	Button background color hex
`--end`	`float64`	Yes	`0`	End time in seconds
`--label`	`string`	Yes		Button label text
`--link`	`string`			URL the button links to
`--position`	`string`		`top-right`	Position: top-right, top-left, bottom-right, bottom-left
`--show-only-at-end`	`bool`		`false`	Only show at end of recording
`--start`	`float64`	Yes	`0`	Start time in seconds
`--text-color`	`string`		`#FFFFFF`	Button text color hex

Sample output (--json)

{
  "data": {
    "id": "c47e2f81-6a90-4b3d-8e21-5f0c9d7b1a63",
    "recording_id": "4f9c2a1b7e5d3086af12",
    "label": "Book a demo",
    "link": "https://acme.neetocal.com/meeting-with-oliver",
    "start": 30.0,
    "end": 90.0,
    "position": "bottom-right",
    "background_color": "#000000",
    "text_color": "#FFFFFF",
    "show_only_at_end": false
  }
}

Getting started

Commands

List recordings

Show a recording

Search recordings by title

Search recordings by transcript

Upload a video

Update a recording

Delete a recording

Show a transcript

Check transcript status

Generate a transcript

Show chapters

Check chapter status

Generate chapters

Get the embed code

Get the download URL

Generate the MP4

Get a screenshot

Show recording analytics

List CTAs

Show action items

Generate action items

Create a CTA

​List recordings

​Show a recording

​Search recordings by title

​Search recordings by transcript

​Upload a video

​Update a recording

​Delete a recording

​Show a transcript

​Check transcript status

​Generate a transcript

​Show chapters

​Check chapter status

​Generate chapters

​Get the share link

​Get the embed code

​Get the download URL

​Generate the MP4

​Get a screenshot

​Show recording analytics

​List CTAs

​Show action items

​Generate action items

​Create a CTA

List recordings

Show a recording

Search recordings by title

Search recordings by transcript

Upload a video

Update a recording

Delete a recording

Show a transcript

Check transcript status

Generate a transcript

Show chapters

Check chapter status

Generate chapters

Get the share link

Get the embed code

Get the download URL

Generate the MP4

Get a screenshot

Show recording analytics

List CTAs

Show action items

Generate action items

Create a CTA