List the user's posts. Filter by status (draft, scheduled, publishing, published, failed) and/or platform. Paginated.

Read one post by id, including its per-platform publish results.

Create a draft or scheduled post. Pass is_draft=true to save as draft (no schedule). Otherwise set scheduledFor (ISO 8601 UTC) to schedule. Use libraryItemId for single media or mediaIds for carousels (max 10).

Update a draft or scheduled post. Pass only the fields you want to change.

Delete a post (cancels it if scheduled). Irreversible.

Publish a draft post immediately. Skips the schedule queue.

List items in the user's media library. Filter by type (image, video, gif, clip) and folder. Paginated.

Import a file into the library. Two modes: (1) by URL — pass url (HTTPS direct-download, 200MB cap, e.g. Dropbox/Canva); (2) by base64 — pass data (raw bytes, 3MB cap) + mimeType. Use source: 'direct' for base64 uploads from agent memory.

Delete a media library item. Irreversible.

List the social accounts the user has connected to ViralNote.

List published posts with their per-platform analytics (views, likes, comments, shares, engagement). Filter by platform. Note: ViralNote refreshes metrics periodically; this returns the latest collected values.

List recent published or failed posts with per-platform delivery results (success or error per platform). Use to see which platforms a post landed on and what errors occurred.

List the user's webhook subscriptions.

Subscribe to ViralNote events (e.g. post.published, post.failed) at a URL you control.

Delete a webhook subscription.