Films

A film is a motion picture that is shown in a cinema. Films can also be other types of content that can be shown in a cinema.

Film

A film is a product that can be shown in a cinema.

film_id required	string (Film_id) The `film_id` is a unique identifier for a film across all films.
title required	string The name of the film. This is how the film will be displayed within Movio EQ.
distributor	string The distributor of the film.
rating	string The rating of the film.
opening_date	string <date> This is the date that the film were offically released to the public.
genres	Array of strings (Genres) The genres of the film.

{"film_id": "captain_america-civil_war",
"title": "Captain America: Civil War",
"distributor": "Walt Disney Pictures",
"rating": "M",
"opening_date": "2024-08-06",
"genres": ["Action",
"Adventure"
]
}

Create / Update Films

Creates or updates a film in the system. This will create the film in Movio if the film does not exist. If the film exists, then the film with the same film_id will be one to one replaced with the new film.

SecurityOAuth2

Request

Request Body schema: application/json
required

The films to be created.

Array ([ 1 .. 5000 ] items)

film_id required	string (Film_id) The `film_id` is a unique identifier for a film across all films.
title required	string The name of the film. This is how the film will be displayed within Movio EQ.
distributor	string The distributor of the film.
rating	string The rating of the film.
opening_date	string <date> This is the date that the film were offically released to the public.
genres	Array of strings (Genres) The genres of the film.

Responses

202

The response to a bulk request that succeeded.

400

The response to a bulk request that failed.

401

The request has not been applied because it lacks valid authentication credentials for the target resource.

422

The request was well-formed but was unable to be followed due to semantic errors.

put/films

Request samples

Payload

application/json

[{"film_id": "captain_america-civil_war",
"title": "Captain America: Civil War",
"distributor": "Walt Disney Pictures",
"rating": "M",
"opening_date": "2024-08-06",
"genres": ["Action",
"Adventure"
]
}
]

Response samples

application/json

{"total": 3,
"created_count": 2,
"updated_count": 1
}

Delete Film

Deletes a film from the system. This effectively remove the film from Movio. Useful when a film is no longer available for screening. Movio will keep the film in the system for historical purposes.

SecurityOAuth2

Request

path Parameters

film_id

required

string (Film_id)

The unique identifier for a film.

Example: captain_america-civil_war

Responses

204

The film was deleted successfully.

400

The request could not be understood by the server due to malformed syntax.

401

The request has not been applied because it lacks valid authentication credentials for the target resource.

422

The request was well-formed but was unable to be followed due to semantic errors.

delete/films/{film_id}