API Reference

Delete custom field

Deletes a custom field by its ID

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

Deletes a custom field by its ID.

Detailed Description

Permanently deletes a custom field from a specific video. The custom field is identified by its unique ID. This action cannot be undone.

HTTP Method & Path

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

Example:
DELETE /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

NameInTypeRequiredDescription
AuthorizationheaderstringYesPanda API token (without Bearer prefix)
video_idpathstring (uuid)YesUnique identifier for the video (e.g., 123e4567-e89b-12d3-a456-426614174000)
custom_fieldsquerystringYesMust be present to delete a custom field
idquerystring (uuid)YesUnique identifier for the custom field to delete (e.g., 987fcdeb-51a2-4e59-a125-23379b3692b5)

Response

Success Response (200)

Returns a confirmation message:

{
  "message": "Custom field deleted successfully"
}

Error Responses

  • 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 DELETE \
  '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 'Accept: application/json'
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!