Recordings

Recordings are 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.

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.

List recordings

Lists the recordings in the workspace, newest first. Use it to find a recording id to pass to the other commands.

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

Flag	Type	Required	Default	Description
`--page`	`int`		`0`	Page number
`--page-size`	`int`		`0`	Items per page (max 100)

{
  "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"
    }
  ],
  "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

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

Searches recordings by title. Use it 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

Searches the text of recording transcripts. Use it 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.

Update a recording

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

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.

Recording deleted.

Show a transcript

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.

{
  "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

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.

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

Generate a transcript

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’)

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

Show chapters

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.

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

Check chapter status

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.

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

Generate chapters

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.

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

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.

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

Get the embed code

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.

{
  "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

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’

{
  "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

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.

{
  "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

Returns a URL to a still frame captured at a timestamp. Useful for pulling a thumbnail out of a recording, or for looking 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.

{
  "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

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.

{
  "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

Lists the call to action buttons configured on a recording.

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

Required arguments

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

{
  "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",
        "show_only_at_end": false
      }
    ]
  }
}

Create a CTA

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

{
  "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

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

Create a CTA

​List recordings

​Show a recording

​Search recordings by title

​Search recordings by transcript

​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

​Create a CTA

List recordings

Show a recording

Search recordings by title

Search recordings by transcript

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

Create a CTA