PUT /videos/{video_id}?custom_fields&id={custom_field_id}

Updates an existing custom field for a specific video by its ID.

Detailed Description

Updates an existing custom field for a specific video. The custom field is identified by its unique ID. You can update either the key, the value, or both. The key is optional but if provided, must be unique per video and has a maximum length of 200 characters. The value is required, cannot be empty, and has a maximum length of 500 characters.

HTTP Method & Path

PUT /videos/{video_id}?custom_fields&id={custom_field_id}

Example:
PUT /videos/123e4567-e89b-12d3-a456-426614174000?custom_fields&id=987fcdeb-51a2-4e59-a125-23379b3692b5

Authentication Requirements

Security Scheme: PandaAuth (apiKey)
Header: Authorization: <your_api_token> (no Bearer prefix)

Parameters

Name	In	Type	Required	Description
`Authorization`	header	string	Yes	Panda API token (without Bearer prefix)
`video_id`	path	string (uuid)	Yes	Unique identifier for the video
`custom_fields`	query	string	Yes	Must be present to update a custom field
`id`	query	string (uuid)	Yes	Unique identifier for the custom field to update

Request Body

{
  "key": "updated_category",
  "value": "Updated Educational Content"
}

Request Body Schema

Field	Type	Required	Description	Constraints
`key`	string	No	New key for the custom field. Optional - if provided, must be unique per video.	1-200 characters, alphanumeric
`value`	string	Yes	New value for the custom field. Required and cannot be empty.	Max 500 characters

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": "2023-01-15T10:30:00Z",
  "updated_at": "2023-01-15T11:45:00Z"
}

Error Responses

400 Bad Request: Invalid input data or validation errors
401 Unauthorized: Invalid or missing API token
404 Not Found: Video or custom field not found
500 Internal Server Error: Server error

Example Usage

curl -X PUT \
'https://api-v2-staging.pandavideo.com/videos/123e4567-e89b-12d3-a456-426614174000?custom_fields&id=987fcdeb-51a2-4e59-a125-23379b3692b5' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '{
"key": "updated_category",
"value": "Updated Educational Content"
}'

200Custom field updated successfully

400Bad request - invalid input data

401Authentication required or invalid credentials

404Resource not found

500Internal server error