Adako

Compose a performance report now

Composes a report from Adako's synced data and stores it, so it also has a permanent web page. Returns immediately — no platform calls, no waiting. Free. Use when: the user asks how a period went, wants a summary to forward, or asks for "a report" or "a brief" — including when they name one platform, because this covers every connected account and keeps the page. Prefer it over the per-platform performance tools whenever the answer is meant to be kept or sent on: those read one platform live and store nothing. Do not use when: the user asks about today — today is still syncing; use the live performance tools for "right now". report_type: performance_brief (totals, per account, top campaigns), detailed_analysis (adds the biggest movers), executive_summary (totals and a few lines). Pass either date_range or start_date + end_date, never both. Every period is compared with the equally long period immediately before it. Periods follow each account's own timezone and cover complete days only: a day that has not ended in an account's timezone is left out, and the report says when an account's days differ from the headline period. Returns the report as markdown plus a link to its page. The user can email it to themselves from that page; for recurring delivery use schedule_brief. If you are unsure which accounts, cadence or period the user means, ask rather than guessing.

post/api/v1/tools/generate_report_now/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/generate_report_now/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.