Tool reference — Data & Site

Report tools

Branded, expiring report links you can share with a client.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Write tools1 tools

create_shareable_report

كتابة2 credits

Create a white-label, read-only, expiring link to the period report (spend, orders, revenue, CPA, ROAS, channel breakdown, daily orders, site summary) headed by the brand's own name and logo instead of Tecrübe — for sending to a client. Needs the reporting.whitelabel plan right; otherwise returns an error and charges no credits.

Parameter	Type	Description
`period`Optional	week \| month	last 7 or 30 days (default week)
`channels`Optional	array<string>	only these channels, e.g. ['google','meta']; default all
`brand_id`Optional	string	brand whose name/logo heads the report; default the main brand
`expires_in_days`Optional	integer (1–90)	default 30

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.