Bardiyah

Update a scheduled item the signed-in user can edit - move the date, or revise the caption, hashtags or call to action. Only the fields you pass are changed.

update-content-schedule

Update a storyboard the signed-in user can edit - retitle it, or move its workflow status. Only the fields you pass are changed.

update-storyboard

Update a content series the signed-in user can edit. Only the fields you pass are changed; an update that would empty the description is refused.

update-content-series

Partially update a content idea owned by the signed-in user. Only the fields you pass are changed. Returns an error if the idea does not exist or belongs to another user.

update-idea

Update a project the signed-in user owns or manages. Only the fields you pass are changed. Returns an error if the project does not exist or the user cannot manage it.

update-project

Update an equipment item the signed-in user can edit - change its status, quantity, who is carrying it, or the notes. Only the fields you pass are changed.

update-equipment-item

Update a thumbnail brief - the written plan for a thumbnail - that the signed-in user can edit in their own Bardiyah workspace: sharpen the concept, the emotion or the text direction. It only records the words you provide; it generates no image, fetches no image, and uploads nothing to YouTube or any other outside service. Only the fields you pass are changed; an update that would empty a section is refused.

update-thumbnail-brief

Update a filming location the signed-in user can edit - add or refine the notes on timing, parking, safety and sound. Only the fields you pass are changed. New locations are added in Bardiyah, where the country is chosen from a list.

update-filming-location

Update a script the signed-in user can edit. Only what you send is changed. Send your rating out of ten to set or revise it — Bardiyah stores the number you send and never works one out itself. Returns an error if the script does not exist or the user cannot edit it.

update-script

Update a shoot day the signed-in user can edit in their own Bardiyah workspace - move the date, change the call time, or extend the notes on weather, transport, permits and the backup plan. It only records what you provide: the weather is the user's own expectation, not a forecast it looks up, and it books no transport and applies for no permit. Nothing is fetched from any outside service. Only the fields you pass are changed.

update-shoot-day

Schedule a script for publication. Say which script, by name, and when it should go out. Use this to plan when something is published and to draft the caption that goes with it. Every scheduled item belongs to exactly one script.

create-content-schedule

List the days of filming the signed-in user can reach, with their dates and what each one is for. Returns short summaries; call get-shoot-day for one in full. Can be narrowed to one project, or to the days filming a particular script, by name.

list-shoot-days

List the signed-in user's content ideas. Returns short summaries — a plain-text taste of each idea rather than the whole thing — so fetch the full text with get-idea. Supports free-text search over the title and the body, an optional status filter (draft, validated, converted) and paging. Use this to find ideas before reading or editing one.

list-ideas

List the storyboards the signed-in user can reach. Returns short summaries; call get-storyboard for one in full. Can be narrowed to a single script by name.

list-storyboards

List the projects the signed-in user can reach: the ones they own plus any they are an active member of. Returns short summaries — the name, the website and how many scripts and ideas each one holds — not what is inside them; call get-project for one project, or search to find content across all of them. Supports free-text search over the project name, and paging.

list-projects

List the equipment the signed-in user can reach, with its category and whether it is available. Returns short summaries; call get-equipment-item for one in full. Can be narrowed to one project by name.

list-equipment-items

List the scripts the signed-in user can reach. Returns short summaries — the title, the project, the status and the rating — never the writing itself; call get-script for the sections of one script, or search when you are looking for a phrase rather than browsing. Can be narrowed to one project, and searched by title. Paged.

list-scripts

List the signed-in user's scheduled content: the publish times, captions and calls to action attached to scripts. Returns short summaries; call get-content-schedule for one in full. Can be narrowed to a single script by name.

list-content-schedules

List the content series the signed-in user can reach. A series groups related videos — a season, a recurring format, a themed run. Returns short summaries; call get-content-series for one in full. Can be narrowed to one project, or searched by title.

list-content-series

List the thumbnail briefs the signed-in user can reach. Returns short summaries; call get-thumbnail-brief for one in full. Can be narrowed to one project, or to the briefs written for a particular script, by name.

list-thumbnail-briefs

List the filming locations the signed-in user can reach, with their kind and their name. Returns short summaries; call get-filming-location for one in full.

list-filming-locations

Fetch one storyboard in full - its title, kind and workflow status. The individual cards, shots and scenes inside it are edited in Bardiyah, not through this server.

get-storyboard

Fetch one content series in full, with its description, its kind and the project it belongs to. Use list-content-series or search to find which one you want first.

get-content-series

Fetch one scheduled item in full — when it goes out, its caption, its description, its hashtags, its call to action, and the script it belongs to.

get-content-schedule

Fetch one content idea owned by the signed-in user, with its full text, its status and the project it sits in. The text comes back ready to edit; revise it and send the revised version to update-idea. Returns an error if the idea does not exist or belongs to somebody else.

get-idea

Fetch a single project the signed-in user can access, including counts of its scripts and ideas. Returns an error if the project does not exist or the user cannot access it.

get-project

Fetch one equipment item in full - its category, quantity, status, who is carrying it and any notes.

get-equipment-item

Fetch one thumbnail brief in full - the concept, subject placement, emotion, text direction, background, palette and the object the eye should reach first.

get-thumbnail-brief

Fetch one filming location in full - the map link, the best time to shoot, and the notes on parking, safety and sound.

get-filming-location

Fetch one script the signed-in user can reach, together with all of its sections in order. Each section's text comes back ready to edit; work from that and send your revision back the same way. Returns an error if the script does not exist or the user cannot reach it.

get-script

Fetch one shoot day in full - the date, call time, plan, expected weather, transport, permits and backup plan.

get-shoot-day