Update Movie

Update an existing movie (Admin only)

PUT /movies/:id

Update Movie

cURL

curl --request PUT \
  --url https://api.example.com/movies/:id \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "duration": 123,
  "main_language": "<string>",
  "release_year": 123,
  "nationality": "<string>",
  "selection_status": {},
  "youtube_link": "<string>",
  "production": "<string>",
  "workshop": "<string>",
  "ai_tool": "<string>",
  "translation": "<string>",
  "synopsis": "<string>",
  "synopsis_anglais": "<string>",
  "admin_comment": "<string>",
  "jury_comment": "<string>"
}
'

200

{
  "message": "Film mis à jour avec succès",
  "movie": {
    "id_movie": 15,
    "title": "The Neural Canvas (Updated)",
    "description": "An experimental exploration of machine learning and visual art - Extended edition",
    "duration": 115,
    "main_language": "French",
    "release_year": 2025,
    "nationality": "Belgium",
    "display_picture": "poster-1710234567-987654321.jpg",
    "picture1": "thumbnail1-1710267890-456789123.jpg",
    "picture2": "thumbnail2-1710234567-987654321.jpg",
    "picture3": "thumbnail3-1710234567-987654321.jpg",
    "trailer": "filmFile-1710234567-987654321.mp4",
    "youtube_link": "https://youtube.com/watch?v=updated",
    "production": "Fully AI-Generated",
    "workshop": "Advanced Generative Art Techniques",
    "translation": "English",
    "synopsis": "Une exploration expérimentale approfondie de l'apprentissage automatique et de l'art visuel",
    "synopsis_anglais": "An in-depth experimental exploration of machine learning and visual art",
    "subtitle": "subtitlesSrt-1710267890-456789123.srt",
    "ai_tool": "Stable Diffusion XL, Pika Labs, ComfyUI",
    "thumbnail": "thumbnail1-1710267890-456789123.jpg",
    "selection_status": "finalist",
    "jury_comment": "Outstanding visual creativity and innovative use of AI. Highly recommended for awards.",
    "admin_comment": "Updated with extended edition. Strong finalist.",
    "id_user": 78,
    "createdAt": "2025-02-15T08:45:00.000Z",
    "updatedAt": "2025-03-07T11:30:00.000Z"
  }
}

Overview

Updates movie details. Only administrators can modify movies. Supports file uploads for updating media files.

Authentication

Authorization · string · required

Bearer token for authenticated user with ADMIN role

Path Parameters

id · integer · required

The unique identifier of the movie to update

Request Body

Supports multipart/form-data for file uploads or application/json for metadata updates.

Updateable Fields

All fields from the movie model can be updated:

title · string

Movie title

description · text

Movie description/synopsis

duration · integer

Duration in seconds

main_language · string

Main language

release_year · integer

Year of release

nationality · string

Country of origin

selection_status · enum

Status: submitted, assigned, to_discuss, candidate, awarded, refused, selected, finalist

youtube_link · string

YouTube video URL

production · string

Production company or AI classification

workshop · string

Workshop or AI methodology

ai_tool · string

AI tools used

translation · string

Translation language

synopsis · text

Synopsis in French

synopsis_anglais · text

Synopsis in English

admin_comment · text

Internal admin notes

jury_comment · text

Jury feedback

Media File Updates

filmFile · file

New video file (replaces trailer)

thumbnail1 · file

New first thumbnail (replaces picture1 and thumbnail)

thumbnail2 · file

New second thumbnail (replaces picture2)

thumbnail3 · file

New third thumbnail (replaces picture3)

subtitlesSrt · file

New subtitle file (replaces subtitle)

Response

message · string

Success message

movie · object

The updated movie object

200

{
  "message": "Film mis à jour avec succès",
  "movie": {
    "id_movie": 15,
    "title": "The Neural Canvas (Updated)",
    "description": "An experimental exploration of machine learning and visual art - Extended edition",
    "duration": 115,
    "main_language": "French",
    "release_year": 2025,
    "nationality": "Belgium",
    "display_picture": "poster-1710234567-987654321.jpg",
    "picture1": "thumbnail1-1710267890-456789123.jpg",
    "picture2": "thumbnail2-1710234567-987654321.jpg",
    "picture3": "thumbnail3-1710234567-987654321.jpg",
    "trailer": "filmFile-1710234567-987654321.mp4",
    "youtube_link": "https://youtube.com/watch?v=updated",
    "production": "Fully AI-Generated",
    "workshop": "Advanced Generative Art Techniques",
    "translation": "English",
    "synopsis": "Une exploration expérimentale approfondie de l'apprentissage automatique et de l'art visuel",
    "synopsis_anglais": "An in-depth experimental exploration of machine learning and visual art",
    "subtitle": "subtitlesSrt-1710267890-456789123.srt",
    "ai_tool": "Stable Diffusion XL, Pika Labs, ComfyUI",
    "thumbnail": "thumbnail1-1710267890-456789123.jpg",
    "selection_status": "finalist",
    "jury_comment": "Outstanding visual creativity and innovative use of AI. Highly recommended for awards.",
    "admin_comment": "Updated with extended edition. Strong finalist.",
    "id_user": 78,
    "createdAt": "2025-02-15T08:45:00.000Z",
    "updatedAt": "2025-03-07T11:30:00.000Z"
  }
}

Error Responses

403

{
  "error": "Seul un administrateur peut modifier un film"
}

404

{
  "error": "Film non trouvé"
}

500

{
  "error": "Internal server error"
}

Example Request

curl -X PUT https://api.marsai.com/movies/15 \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -F "title=The Neural Canvas (Updated)" \
  -F "duration=115" \
  -F "selection_status=finalist" \
  -F "ai_tool=Stable Diffusion XL, Pika Labs, ComfyUI" \
  -F "admin_comment=Updated with extended edition. Strong finalist." \
  -F "jury_comment=Outstanding visual creativity and innovative use of AI. Highly recommended for awards." \
  -F "thumbnail1=@/path/to/new-thumb.jpg" \
  -F "subtitlesSrt=@/path/to/updated-subtitles.srt"

Notes

• Admin only: Only users with ADMIN role can update movies
• File uploads replace existing files - the new filename is stored in the database
• All request body fields are optional - only provided fields will be updated
• The updatedAt timestamp is automatically updated
• To update categories, collaborators, or juries, use the specialized endpoints:
  • PUT /movies/:id/categories
  • PUT /movies/:id/collaborators
  • PUT /movies/:id/juries