---
title: "Put Video Non Human Spans"
method: PUT
path: "/v2/videos/{video_id}/non-human-spans"
tags: ["Video Emotion API"]
---

# Put Video Non Human Spans

`PUT /v2/videos/{video_id}/non-human-spans`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v2/videos/{video_id}/non-human-spans`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Replace known non-human audio, such as a voice assistant or music.

The body is the whole list. ``[]`` clears it. Every span must lie within the
video. 409 ``video_duration_unknown`` until the duration is known. 422
``non_human_span_out_of_range`` when a span ends after the video, 422
``non_human_spans_clock_unsupported`` when the video was analysed from
``start_millis`` > 0, and 422 ``non_human_spans_too_large`` when the stored
list exceeds its size cap.

Sending this list does not by itself remove a speaker from analysis results.
A span is recorded time. A speaker marked ``system`` or ``media`` on the
audio is what leaves Moments.

Owner or ``media:write``. Not available to a delegated token. No charge.

## Path parameters

- `video_id` string, required: The unique ID of the video.

## Request body

- NonHumanSpansRequest: Body of ``PUT /v2/videos/{video_id}/non-human-spans``. ``[]`` clears.
  - `non_human_spans` NonHumanSpan[], required
    - `start_ms` integer, required: When it starts, in milliseconds.
    - `end_ms` integer, required: When it ends, in milliseconds. After start_ms.
    - `role` 'system' | 'media', required: Who is speaking: "system" or "media".
    - `label` string, nullable: Optional name, 1-80 characters after surrounding spaces are removed.

## Response `200`

Successful Response

- NonHumanSpansResponse: The list as stored, in the order sent.
  - `video_id` string, required
  - `non_human_spans` NonHumanSpan[], required
    - `start_ms` integer, required: When it starts, in milliseconds.
    - `end_ms` integer, required: When it ends, in milliseconds. After start_ms.
    - `role` 'system' | 'media', required: Who is speaking: "system" or "media".
    - `label` string, nullable: Optional name, 1-80 characters after surrounding spaces are removed.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-01** `72330e2229c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/videos/:video_id/non-human-spans/put.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)