Agent Workflows
Update published content

Update published content

Edit the metadata (title, description, tags, privacy) of an already published post directly on the platform.

User intents

"Change the title of my published video to 'Q2 Launch — Updated'." "Make my published YouTube video unlisted."

Required information

  • The assignmentId of the published post.
  • The fields to change: title, description, tags (JSON array string), privacy.

Preconditions

  • The assignment is already published.
  • YouTube only today.
  • The connection token is valid.

Tool sequence

Locate the published assignment

list_assignments (status: published) or get_assignment by ID.

Apply the change

update_published_content with assignmentId and the fields to update. Changes are pushed to the platform in real time.

⚠️

For assignments that have not published yet, use update_assignment instead — update_published_content is only for live posts.

REST alternative

Backed by the assignment update endpoints — see the Assignments reference.

Recovery paths

  • Token expired — re-authorize via get_oauth_connect_url, then retry.
  • Facebook target — not supported yet; tell the user this edit is YouTube-only.
  • Validation error — respect limits: title ≤ 100 chars, description ≤ 5000 chars, tags ≤ 500 chars total; privacypublic/unlisted/private.

Example prompt → result

"Rename my published video a1b2c3d4 to 'Launch — Director's Cut' and make it unlisted."

Result: the YouTube video's title and privacy update immediately on the platform.

Common mistakes

  • Using update_assignment on a published post (it only works pre-publish).
  • Sending tags as an array instead of a JSON string.

Related docs

Publishing guide · Tool reference · Schedule a post