PHPeerTube - A PHP‑based federated video platform, inspired by PeerTube.

Copyright (C) 2025 Lucentinian Works Co Ltd

PATCH /me/videos/{id} - Update Video Details (Draft Videos Only)

This endpoint allows a logged-in user to update the title and/or description of a video that is currently in draft status.

Request

PATCH /me/videos/{id}

Path Parameters

• id (integer, required): The ID of the video to update.

Request Body (application/json)

Provide at least one of the following fields:

• title (string, optional): The new title for the video.
• description (string, optional): The new description for the video.

Example cURL Request

curl -X PATCH \
  http://localhost:8080/me/videos/123 \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "title": "My Updated Video Title", "description": "A new and improved description for my draft video." }'

Example Success Response (Status: 200 OK)

{
  "message": "Video details updated successfully."
}

Example Error Responses

400 Bad Request

{
  "error": "No title or description provided for update."
}

401 Unauthorized

{
  "error": "Unauthorized: Missing or invalid token."
}

404 Not Found

{
  "error": "Video not found, not owned by user, or not in draft status."
}

500 Internal Server Error

{
  "error": "Failed to update video details."
}