Pomo

Read saved provider observations for an exact inclusive date period and company profile. Filter by campaign, ad, account or provider; drill down by campaign, ad group, ad or account. Currency, source grain, attribution and coverage stay explicit. Daily drilldown pages one entity at a time; matched comparison periods never infer missing zeros or unspecified attribution. Requirements: Select an exact company profile. For provider-native IDs also supply the provider and account.

pomo_campaigns_performance

Apply the person's timing change (for example 'Thursday instead') to an exact offer or accepted check. Preserve all saved purpose/source/delivery terms and unchanged clock time/zone. Changing a proposed offer does not accept it; changing an accepted check replaces its prior occurrence.

pomo_follow_ups_update

Change what the scheduled social listening scan listens for: the lookback window (7, 30 or 60 days), the custom topics list, or the per-target query terms (optionally per platform). Each provided list replaces the saved list; omitted fields are kept. Requires the version from the latest settings read and fails with stale_work when the settings changed since. Does not start a scan. Requirements: Read the settings first and pass the returned version as expected_version. A per-target override must name an active tracked target from the settings read.

pomo_listening_track

Find every matching saved campaign in the selected company and check each platform campaign directly with its provider. Use for questions such as whether all Meta campaigns are paused, which campaigns are live, or delivery across named campaigns. Pomo handles all discovery pages and provider reads in one saved status check; campaigns are selected by their saved identity, not by cached delivery state. This only saves a verification report; it does not change ads, spend, or approvals.

pomo_campaigns_check_status

Read one saved work item by work_id: its state, progress, artifacts and, when a person must decide, the complete review terms and the tool that confirms them. wait_seconds holds the call open for up to 20 seconds while the work is queued or running; input, approval and scheduled states return immediately. Copy and images take 1–5 minutes, a video up to 10. Confirmations made with the button inside the chat are recorded on the work, so the latest read reflects them. Mounts no card; pomo_work_view reopens the same work on screen.

pomo_work_get

Save the person's explicitly requested future check of one published Instagram post's lifetime likes and comments. Pomo owns the schedule; results are saved in Pomo and available when the person returns. This does not notify or wake the external assistant, publish, measure sales, or run an AI Team. cadence: once — Check this published post later; recurring — Keep checking this published post.

pomo_follow_ups_create

Open an image picker card for the selected company, for when the person wants to use an image from their own device. Opening the picker changes nothing; the person selects and saves the original through the card, and its verified Gallery reference returns to this conversation for the request that needed it. An image attached to the chat is saved with pomo_upload_image instead.

pomo_upload_picker

Read the ads Pomo recorded for tracked competitors from public ad libraries and their sites: copy, call to action, format, source and the dates the source reported, newest first. Reads saved ads only; it does not scan.

pomo_competitors_ads

Inspect the current saved competitor recommendation and complete evidence, without starting research. Returns the current input hash for an explicit check.

pomo_competitors_get

Confirm saved work that is waiting for the person's decision (state needs_input with a review and confirm_tool), as the confirm button in Pomo does: it starts the reviewed action — rendering a video, scheduling a post, launching or changing a paid campaign, sending an email. Requires the person's explicit approval of the review terms shown to them in this conversation, the current work_id and expected_revision and, for a paid review, every statement in review.acknowledgements repeated verbatim in accepted_acknowledgements. Requires the write permission for the work's domain. Change Management approvals (state needs_approval) are decided in Pomo. The result reports the work's new state; pomo_work_get follows its progress.

pomo_work_confirm

Save a new paid campaign draft from the chosen brief, audience, product and channels. An existing campaign is continued with update or update_copy rather than a second create. Video campaigns first save copy and opening frames; the saved work then presents a Render videos review, and confirmation continues the same campaigns and any deferred placements. Does not launch or spend ad budget. Requirements: The user requests a new campaign deliverable. Existing saved work is inspected or edited, not regenerated by continuing this operation. Provide the selected product UUID and native channel keys from this input schema. A work ID is not a campaign or generation job ID. Native credit and usage limits apply.

pomo_campaigns_create

Generate an article from a prompt, or save one the person already wrote. action: generate — Write a new article; save — Save finished copy. Requirements: Use for new writing from a brief of at most 2,000 characters. To save finished copy already written in this conversation, use pomo_articles_create (action: save); do not place the full copy into this generation brief. article_length.v1: an approximate target uses an inclusive ±20% reader-word band. Aim at the target. A missed achievable band and/or explicit maximum share at most one additional metered provider response per writing attempt. Every draft must fit an explicit maximum; of the drafts that fit, the one nearer the target is saved, so a correction never replaces a fitting draft with a worse one. When no draft fits, it fails the job without retry and saves no new text. A target is guidance: a saved draft outside its band completes with its actual count and unmet target reported. An incompatible hard maximum takes priority and is reported as constraining the target. A transient writer failure in either call can rerun the whole attempt within the job's ordinary retry limit. Both responses incur provider usage through the existing provider telemetry; this adds no per-response organization credit charge or refund promise. Native credit and usage limits apply to generate.

pomo_articles_create

Generate new images from a prompt, or refine a saved image with instructions. action refine is a change to an identified saved image; it saves a new image, and an ad keeps its old picture until pomo_campaigns_update (section: settings) attaches the new one. action: create — Create images; refine — Refine a saved image. Requirements: Use owned gallery IDs for image references, especially the exact product packaging when fidelity matters. A product description alone is not a visual reference. Use for new image concepts. Use pomo_creative_image_create (action: refine) when the user asks to modify an existing image so its exact visual source is preserved. For faithful branded products, locate or request approved visual references first. Without them, present only an explicitly unverified concept. Read the selected image with pomo_creative_get and use that image_id and current content_version. Preserve the exact source; do not replace an edit with a fresh creation request. Specify aspect_ratio for a requested canvas format. Supply exact owned reference_gallery_ids for product packaging or other visual elements to add. Use creative.images.update_metadata for title, description or tags without a pixel change. Native credit and usage limits apply to create, refine.

pomo_creative_image_create

Generate saved social posts with copy and media from a brief, audience and supported placements. Each video is a separate post: its saved opening frame, prompt and usage require the person's Render video button before rendering. No scheduling or publication occurs. Native credit and usage limits apply.

pomo_social_create

Read a creator search's actual progress or bounded results. Result indices refer to this saved search and can be selected into a shortlist.

pomo_influencers_search_get

Read this launched campaign's current status, budget and schedule directly from the connected platform. Use after an interrupted platform operation or to distinguish live delivery from unsynced saved edits.

pomo_campaigns_status

Prepare an approve, dismiss or defer decision on a staged card, optionally keeping only some creatives, rescheduling posts or choosing optimization options. For an optimization, the person can take one of its alternatives or counter with their own daily budget inside the guardrail window; either revises this same decision in place. Shows the exact terms, spend and effect for a person to confirm in Pomo. Confirming applies the decision natively: approved ads launch, posts schedule, optimizations apply. Requirements: Read the decision first; expected_version must match the current version. Only open decisions can be decided. Native credit and usage limits apply. Ends in the person's decision: the result carries the exact review terms and how to confirm them here.

pomo_team_decide

Discover authorized workspaces, then inspect resource kinds, fields, operations, projections, and relationships in one workspace.

pomo_workspace_describe

Write an outreach email for a candidate, or edit the draft on a candidate or a saved lead. action: write — Draft lead outreach; edit_candidate — Refine a lead draft; edit_lead — Update a saved lead draft. Native credit and usage limits apply to write.

pomo_leads_draft_outreach

Edit a project's brief, save edits to a draft, or rewrite a draft with an instruction. action: edit — Update the saved story brief; save_draft — Edit the saved story draft; rewrite — Rewrite this story draft. Native credit and usage limits apply to rewrite.

pomo_earned_media_update

Edit one section of a saved campaign or one of its ads, against the campaign's current version from pomo_campaigns_get. section copy edits the identified ad's supported text, call-to-action or destination fields. section: details — Update a campaign; copy — Edit saved ad text or destination; budget — Update the saved campaign budget plan; targeting — Update supported draft audience choices; bidding — Update supported saved bidding choices; delivery_hours — Update saved delivery hours; settings — Update a saved ad budget or selected media. Requirements: Inspect the current campaign version. Change only fields requested by the user. Description changes the brief; it does not change saved ad copy. Inspect the campaign and select an existing ads[] entry; use its ad_id and platform and the current campaign version. This operation requires a saved typed ad. prepared_ads awaiting frame review are read-only here; open the saved campaign to review and render them first. Use only the selected ad's editable_copy_fields. Budget and media changes belong to pomo_campaigns_update (section: settings); campaign plan changes belong to pomo_campaigns_update (section: details). Read delivery_settings first and use its exact campaign version, ad ID, currency and supported controls. A supported unset-currency initialization needs the person's explicit ISO currency and amount, never an account or brand default. Inspect the campaign and choose an ads[].ad_id; prepared video copy has no ad ID until frame review and rendering finish. Use the current campaign version and the selected ad's recorded budget mode. This operation changes the amount within that mode; it does not convert a shared total budget to a daily budget. For media replacement, use an owned gallery_id and the exact current rendition_id from the selected ad. Timeline edits use pomo_campaigns_update (section: details).

pomo_campaigns_update

Edit specified name, caption or hashtags, or replace one exact image using an owned Gallery image on this same saved post. Use its current creative_state_token as expected_creative_state_token; image replacement also needs the current media[].id and Gallery content version. Other carousel slots and originals remain intact. Scheduled, publishing and submitted posts require their native publication workflow before editing.

pomo_social_update

Edit a saved article's title, subtitle (dek) or body, or regenerate it with an instruction. Use action=edit for a targeted subtitle change. Pass its current content version. action: edit — Revise an article draft; regenerate — Rewrite or retry this article. Requirements: Read title, dek and body_markdown as separate saved fields. A displayed preview may combine them. An opening edit must target the field that owns the intended passage: update dek for the subtitle or use exact text_replacements for a body passage. Never match preview text against the body unless that same exact passage is present in body_markdown. article_length.v1: an approximate target uses an inclusive ±20% reader-word band. Aim at the target. A missed achievable band and/or explicit maximum share at most one additional metered provider response per writing attempt. Every draft must fit an explicit maximum; of the drafts that fit, the one nearer the target is saved, so a correction never replaces a fitting draft with a worse one. When no draft fits, it fails the job without retry and saves no new text. A target is guidance: a saved draft outside its band completes with its actual count and unmet target reported. An incompatible hard maximum takes priority and is reported as constraining the target. A transient writer failure in either call can rerun the whole attempt within the job's ordinary retry limit. Both responses incur provider usage through the existing provider telemetry; this adds no per-response organization credit charge or refund promise. Native credit and usage limits apply to regenerate.

pomo_articles_update

Start a durable search that checks creator profiles using your brief, brand, selected products and filters. Native credit and usage limits apply.

pomo_influencers_search

Start a lead search from a description of who to find, or refresh a saved search. action: discover — Find growth leads; refresh — Refresh a lead search. Native credit and usage limits apply to discover, refresh.

pomo_leads_discover

Complete a prepared direct upload with only workspace_ref and upload_intent after its raw file bytes reached the signed storage URL. Pomo reads only that intent's staging object and verifies its size, checksum and type before native registration. For an inline upload up to 128 KiB, also supply content_base64. Repeat the same intent after a lost response; the saved asset or attachment is reused. Reference files return an attachment_handle for data inspection/import.

pomo_upload_finalize

The brand's first-party sales: a period's totals from a connected Shopify, Square, Klaviyo or QuickBooks account; the imported data — each import, its status and what it contains; or what an uploaded file holds before it is imported. source: shopify, square, klaviyo, quickbooks — Read connected sales; imports — Find saved data workspaces; upload — Inspect an attached data file.

pomo_sales_get

Get one workspace resource by an opaque resource reference returned by search, related, or evidence inspection.

pomo_workspace_get

The saved leads, a search's candidates, or one saved lead in full. view: saved — Find saved leads; search — Inspect a lead search; lead — Inspect a saved lead.

pomo_leads_get

Prepare a precise review of an attached file's column mapping and optional product matches. The user chooses Import data before native upload persistence and background analysis. Repeating with the same work_id and revision replaces the pending mapping review; data is not imported until confirmed.

pomo_sales_import

The brand's influencer campaigns, or one in full with its creators. view: list — Find influencer campaigns; campaign — Inspect an influencer campaign.

pomo_influencers_campaign_get

Inspect exact records or dotted fields from a durable evidence artifact returned by a prior workspace operation.

pomo_workspace_inspect

Read one saved image as bounded inline image content, for inspecting a picture that a campaign or review view already shows without opening another card. artifact_ref is the media_ref or artifact_ref Pomo returned; it may identify Gallery media or one versioned paid-review image. The preview is resized, uses a white background for transparency and shows the first frame of an animated image; the original is unchanged. The result also carries the scoped link to the saved original. Does not generate or change the asset.

pomo_artifact_preview

Prepare an ad's launch on its platform, or a sync of its saved changes to the platform, for the person's confirmation. action: launch — Review a paid campaign launch; sync — Review saved changes for platform sync. Native credit and usage limits apply to launch, sync. Ends in the person's decision: the result carries the exact review terms and how to confirm them here.

pomo_campaigns_launch

Manage only these accepted personal checks. Reconnecting access never resumes them automatically. These controls do not pause a campaign or change a post. Use the exact saved check and definition revision from its work card. action: pause — Pause these checks; resume — Resume these checks; cancel — Stop this personal follow-up.

pomo_follow_ups_control

Read the trends Pomo's scheduled analysis saved for one platform — Google search interest, TikTok, Instagram, YouTube, Yelp or Amazon — over the last 7, 14 or 30 days, with analysis dates, why it matters and what the brand can do. Detailed reports provide the saved analysis and source references. Reads the saved analysis only; it does not collect or generate.

pomo_trends_get

Read one decision card in full: the bundle's creatives with selection ids, copy, platform and schedule, launch readiness (accounts connected, daily budget), the team's rationale and expected outcome, and the version required to decide. For a campaign optimization it also lists each option's alternatives (smaller step, cut instead of pause, wait) and the daily-budget window a person may counter inside.

pomo_team_decisions_get

Read one insight in full: recommendation, why now and what it costs to wait, the evidence, every step of the plan with how to take it (mark done here, decide a staged bundle with team_decisions, or create the work with the named capability), the measurement window and its results, the progress log, the allowed actions and the version required to act. Amounts in it are reported figures without complete price terms; pomo_products_get (view: product) holds a product's current price terms.

pomo_insights_get

Read the exact saved ad headlines and copy, planned budget, flight dates, targeting and current version. Planned amounts are not confirmed provider budget modes or pacing guarantees; launch/sync review owns delivery terms. delivery_settings carries the account-local current date that relative flight dates are judged against. ads[].copy is the saved creative; prepared_ads[].copy is saved video copy awaiting frame review. Campaign description is the original brief, separate from the edited ad text. Requirements: campaign_id is the campaign UUID from a saved campaign artifact or pomo_campaigns_list; input requires a UUID, not a workspace reference.

pomo_campaigns_get

Read a saved image's current content_version and metadata before editing or refining it. Requirements: Reading metadata does not verify visual quality. Inspect the actual saved preview to assess text, logos and product fidelity. Inspect the actual saved preview: logo accuracy, lettering and spelling, garbled text, approved visual references. Generation is not brand approval. Missing evidence: unverified concept; edits cannot supply it. QA does not load product catalog facts; never claim adding or editing a product record will verify claims.

pomo_creative_get