put
https://api-v2.pandavideo.com.br/videos/
Updates a custom field on a video (by id query). key is optional (must stay unique), value is required (1-500 chars).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
PUT /videos/{video_id}?custom_fields&id={custom_field_id}
{video_id}?custom_fields&id={custom_field_id}Updates an existing custom field on a video. The field is identified by id (passed as a query parameter). Both key and value can be updated; sending only one is allowed but the value is always re-validated.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
PUT /videos/{video_id}?custom_fields&id={custom_field_id}
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
video_id | string (uuid) | Yes | ID of the video that owns the field. | uuid |
Query Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
custom_fields | string | Yes | Sentinel flag — must be present (no value). | flag |
id | string (uuid) | Yes | ID of the custom field to update. Obtain it from Get video custom fields. | uuid |
Request Body
Content-Type: application/json
Body Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
key | string | No | New key. Optional; if provided, must be unique per video. | 1–200 chars, alphanumeric |
value | string | Yes | New value. Cannot be empty. | 1–500 chars |
{
"key": "updated_category",
"value": "Updated Educational Content"
}Response
Success Response (200)
Returns the updated custom field object:
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"video_id": "d848feb5-b5a2-4e59-a125-23379b3692b5",
"key": "updated_category",
"value": "Updated Educational Content",
"created_at": "2026-05-29T10:30:00.000Z",
"updated_at": "2026-05-29T11:45:00.000Z"
}Error Responses
- 400 Bad Request — Invalid body, empty
value, or duplicatekey. - 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Video or custom field not found.
- 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X PUT \
'https://api-v2.pandavideo.com.br/videos/<video_id>?custom_fields&id=<custom_field_id>' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '{
"key": "updated_category",
"value": "Updated Educational Content"
}'