How can we help?

Recordings commands

The recordings command lets you manage screen recordings in your workspace.

List recordings

This command shows recordings in your workspace. Use this when you want to inspect available recordings and basic metadata such as title, duration, and folder.

neetorecord recordings list
neetorecord recordings list --page 1 --page-size 2

Optional flags:

  • --page - Page number

  • --page-size - Items per page

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

TITLE               DUR...   CREATED AT     DEFAULT TITLE         FOL...   FOL...   ID
─────────────────   ──────   ────────────   ───────────────────   ──────   ──────   ──────────────────
Discount Code ...   105.23   2026-06-2...   New recording - ...   -        -        14229cda-1781-4...
Discount Code ...   61.37    2026-06-2...   New recording - ...   -        -        fda953c8-34ed-4...

Page 1 of 523 (1046 total records)

  Show: neetorecord recordings show <id>

Show a recording

This command shows details for one recording ID. Use this when you want to inspect title, duration, view count, summary, public URL, and folder assignment.

neetorecord recordings show 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

ID              14229cda-1781-4f34-b654-d939f786b5fb
  TITLE           Discount Code Functionality Issue
  DEFAULT TITLE   New recording - #1046 by Oli Example
  DURATION        105.23
  VIEW COUNT      1
  IS UPLOADED     Yes
  REQUESTED       No
  SUMMARY         The speaker discusses an issue with a discount code that allows a 50 percent discount for one-time use. Both forms submitted simultaneously received the discount, despite the code being intended for only one form, leading to discrepancies in the submissions page.
  PUBLIC LINK ID  a97834ff2b6c0ff2a358
  CREATED AT      2026-06-22T07:42:05.286Z
  UPDATED AT      2026-06-23T07:35:22.547Z
  UPLOADED AT     2026-06-22T07:44:37.753Z
  PUBLIC URL      https://acme.neetorecord.com/watch/a97834ff2b6c0ff2a358
  USER NAME       Oli Example
  TAGS            []
  FOLDER NAME     -
  FOLDER ID       -

Search recordings by title

This command searches recordings by title text. Use this when you remember part of a recording name and want matching results without opening the library UI.

neetorecord recordings search --query "Discount Code"

Required argument:

  • --query - Title search query

Optional flags:

  • --page - Page number

  • --page-size - Items per page

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

TITLE               DUR...   CREATED AT     DEFAULT TITLE         FOL...   FOL...   ID
─────────────────   ──────   ────────────   ───────────────────   ──────   ──────   ──────────────────
Discount Code ...   105.23   2026-06-2...   New recording - ...   -        -        14229cda-1781-4...

Page 1 of 1 (1 total records)

  Show: neetorecord recordings show <id>

Search recordings by transcript

This command searches recordings by spoken content in transcripts. Use this when you need to find recordings that mention specific words or phrases.

neetorecord recordings search-by-transcript --query "discount"

Required argument:

  • --query - Text to search in transcripts

Optional flags:

  • --page - Page number

  • --page-size - Items per page

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

TITLE                    DUR...   CREATED AT    DEFAULT TITLE       FOL...   FOL...   ID
──────────────────────   ──────   ───────────   ─────────────────   ──────   ──────   ────────────────
Email Delivery Auto...   111.31   2025-10-...   New recording ...   -        -        6436b2b2-5194...
Issue with Discount...   50.16    2026-06-...   New recording ...   -        -        770ad0c3-64e9...
Discount Code Valid...   61.37    2026-06-...   New recording ...   -        -        fda953c8-34ed...
Discount Code Funct...   105.23   2026-06-...   New recording ...   -        -        14229cda-1781...

Page 1 of 1 (5 total records)

  Show: neetorecord recordings show <id>

Update a recording

This command updates fields for a recording ID. Use this when you need to change title, summary, folder, or tags from the terminal.

neetorecord recordings update 14229cda-1781-4f34-b654-d939f786b5fb --title "Updated title" --summary "New summary"

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --title - New title

  • --summary - New summary

  • --folder-id - Folder ID to move to (empty to remove from folder)

  • --tag - Tag name (repeatable; replaces all existing tags)

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

ID              14229cda-1781-4f34-b654-d939f786b5fb
  TITLE           Discount Code Functionality Issue
  DEFAULT TITLE   New recording - #1046 by Oli Example
  DURATION        105.23
  VIEW COUNT      1
  IS UPLOADED     Yes
  REQUESTED       No
  SUMMARY         The speaker discusses an issue with a discount code that allows a 50 percent discount for one-time use. Both forms submitted simultaneously received the discount, despite the code being intended for only one form, leading to discrepancies in the submissions page.
  PUBLIC LINK ID  a97834ff2b6c0ff2a358
  USER NAME       Oli Example
  TAGS            []
  FOLDER NAME     -
  FOLDER ID       -

Delete a recording

This command permanently deletes a recording. Use this when a recording should be removed from your workspace.

neetorecord recordings delete 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

Recording deleted.

This command returns the public watch URL for a recording. Use this when you need the shareable link without copying it from the NeetoRecord UI.

neetorecord recordings share-link 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID              a97834ff2b6c0ff2a358
  PUBLIC URL                https://acme.neetorecord.com/watch/a97834ff2b6c0ff2a358
  IS EXPIRED                No
  ACCESS CONTROL PROTECTED  No

Get embed code

This command returns the embed URL and HTML iframe snippet for a recording. Use this when you want to embed a recording on a webpage.

neetorecord recordings embed-code 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID  a97834ff2b6c0ff2a358
  EMBED URL     https://acme.neetorecord.com/embeds/14229cda-1781-4f34-b654-d939f786b5fb
  EMBED HTML    <iframe src="https://acme.neetorecord.com/embeds/14229cda-1781-4f34-b654-d939f786b5fb" width="100%" height="480" frameborder="0" allowfullscreen></iframe>

Get download URL

This command returns a presigned download URL for a recording file. Use this when you need a temporary direct download link.

neetorecord recordings download-url 14229cda-1781-4f34-b654-d939f786b5fb
neetorecord recordings download-url 14229cda-1781-4f34-b654-d939f786b5fb --format webm

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --format - Download format: mp4 or webm (default mp4)

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID            a97834ff2b6c0ff2a358
  FILE FORMAT             mp4
  IS DOWNLOAD FILE READY  Yes
  DOWNLOAD URL            https://d1tp3rmzxt7mnk.cloudfront.net/.../14229cda-1781-4f34-b654-d939f786b5fb.mp4?...
  URL EXPIRES IN SECONDS  600

Get recording analytics

This command returns view analytics for one recording. Use this when you want per-recording view counts and daily breakdowns.

neetorecord recordings analytics 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID  a97834ff2b6c0ff2a358
  TOTAL VIEWS   1
  VIEWS BY DAY  [{"count":5,"date":"2026-06-22"}]

TOTAL VIEWS is the official play count (view_count). VIEWS BY DAY includes all view events, including embed page visits (embed_visit), so daily counts can be higher. See Views calculation.

Get transcript

This command returns the transcript for a recording. Use this when you want spoken content without opening the recording page.

neetorecord recordings transcript 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID  a97834ff2b6c0ff2a358
  TRANSCRIPT    (2 fields)

Check transcript status

This command checks whether transcript generation has completed for a recording. Use this before fetching a transcript or when monitoring processing jobs.

neetorecord recordings transcript-status 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID    a97834ff2b6c0ff2a358
  STATUS          success
  HAS TRANSCRIPT  Yes

Trigger transcript generation

This command starts transcript generation for a recording. Use this when a recording does not yet have a transcript or you want to regenerate it in a specific language.

neetorecord recordings trigger-transcript 14229cda-1781-4f34-b654-d939f786b5fb
neetorecord recordings trigger-transcript 14229cda-1781-4f34-b654-d939f786b5fb --language en

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --language - Language code (e.g. en)

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

  RECORDING ID  83bc4f0c3cbaf4a52ad3
  STATUS        triggered

Get chapters

This command returns AI-generated chapters for a recording. Use this when you want chapter titles and timestamps without opening the player.

neetorecord recordings chapters 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output

RECORDING ID  a97834ff2b6c0ff2a358
  CHAPTERS      (8 items)

Check chapter status

This command checks whether chapter generation has completed for a recording. Use this before fetching chapters or when monitoring processing jobs.

neetorecord recordings chapter-status 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID  a97834ff2b6c0ff2a358
  STATUS        success
  HAS CHAPTERS  Yes

Trigger chapter generation

This command starts chapter generation for a recording. Use this when chapters are missing or you want to regenerate them.

neetorecord recordings trigger-chapters 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Trigger MP4 generation

This command starts MP4 transcoding for a recording. Use this when you need an MP4 download file generated or regenerated.

neetorecord recordings trigger-mp4 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • -h, --help - Show help for the command

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

List CTAs

This command lists call-to-action buttons configured on a recording. Use this when you want to review existing CTAs before adding or editing them.

neetorecord recordings ctas 14229cda-1781-4f34-b654-d939f786b5fb

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

RECORDING ID  a97834ff2b6c0ff2a358
  CTAS          (1 items)

Create a CTA

This command adds a call-to-action button to a recording. Use this when you want to add a labeled link that appears during playback.

neetorecord recordings create-cta 14229cda-1781-4f34-b654-d939f786b5fb --label "Learn more" --start 10 --end 20 --link https://example.com

Required argument:

  • <id> - Recording UUID (internal ID from recordings list) or public link ID

Required flags:

  •  --label - Button label text

  • --start - Start time in seconds

  • --end - End time in seconds

Optional flags:

  • --link - URL the button links to

  • --position - top-right, top-left, bottom-right, bottom-left (default top-right)

  • --background-color - Button background color hex (default #000000)

  • --text-color - Button text color hex (default #FFFFFF)

  • --show-only-at-end - Only show at end of recording

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

ID                8d9cb53f-97ea-4d9f-bc52-a47c977aa98f
  RECORDING ID      a97834ff2b6c0ff2a358
  LABEL             Learn more
  LINK              https://example.com
  START             10
  END               20
  POSITION          top-right
  BACKGROUND COLOR  #000000
  TEXT COLOR        #FFFFFF
  SHOW ONLY AT END  No

Can't find what you're looking for?