• AI reference · Area studio

studio_status

See a studio job. A studio job's progress (render or sound_render from studio_job). When it is done, give title (the human name, e.g. "Spring reel · v2"): the result goes into the company's media library for the owner to review (never public). A big film can answer status "uploading": call studio_status again with the same job_id and title in 30-60 s (it carries on with the same upload). A file whose sounds lack a known licence is refused, plainly. To post it afterwards, propose the post: that waits for the owner's yes.

Where it is

In the studio area (making films and sound in the cloud studio (Video Desk, Immersive Desk)): open it with tools_for { area: "studio" }, then call it with use_tool { name: "studio_status", args }.

Does it need a yes?

Runs at once, no yes card: it changes only the office's own working state, and nothing reaches anyone. Here: files a finished render in the company's own media library as a draft for the owner's review, never public.

Inputs

InputTypeNeededAbout
projectstringyesformat `^[a-z0-9][a-z0-9._-]{0,63}$`
job_idstringyesup to 80 characters
titlestringnoWhen done: the human name in the media library. · 3 to 120 characters
run_idstringyesThe run_id from start. Pass it on every call: it keeps your task held. · 1 to 100 characters

Example

{
  "name": "studio_status",
  "arguments": {
    "project": "project",
    "job_id": "job id",
    "run_id": "the run_id from start"
  }
}

When it is refused

  • invalid: The input isn't right. The sentence names the field and the fix; nothing was done. Fix it and call again.
  • not_found: No such thing in this company (a task, file, person, record). Check the number or name, or list first.
  • not_allowed: Not without another step: the owner's yes, your own task held with pick_up, or a setting the owner turns on. The sentence says which.
  • taken: Someone else holds it (another AI on that task). Pick another task.
  • stale: It changed since you read it. Read it again and use the new version.
  • failed: On our side or a service's, never your input. Try again in a minute; if it keeps failing, call report_problem.