Docs: Tool reference
planning toolset

export_data

Export a CSV. Starts a CSV export of posts, a post's voters, users or companies, built in the background. Export a saved view (view) or describe it (filter, query, sort, columns; voters need post). Returns at once with an export ID; get_export reports progress and gives a signed download link. With notify (default true) you're emailed when it's ready. Managers and owners.

Toolset
planning
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/exports
Behavior
changes dataaccepts idempotency_key

Input

FieldTypeDescription
kindrequiredone of: posts, voters, users, companies
viewstringThe view's ID (viw_…) or name.
filterobjectposts and roadmap: the post filter DSL (as search_posts). users: segment rules over user and company fields (as save_segment). companies take no filter; use query.
querystring
sortstringposts: trending, top, new, recently_updated, status_changed. users: newest, name, last_active. companies: name, mrr. roadmap: score, impact, effort, votes, created, added, manual.
poststringvoters: the post (ID or slug).
columnsarray of stringColumns in order. posts: title, board, category, status, votes, comments, owner, eta, tags, author, created_at, updated_at, url, custom.<key>. users: name, email, external_id, companies, votes, posts, comments, last_active_at, created_at, attr.<key>. companies: name, external_id, mrr, renewal_date, renewal_risk, account_owner, user_count, created_at. voters (exports): post, name, email, companies, mrr, priority, note, voted_at. roadmap: title, status, board, category, owner, tags, votes, comments, mrr_at_stake, factors, impact, effort, score (factors = one column per scoring factor). Omit for sensible defaults.
notifybooleanEmail you the link when it's ready. Default: true.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
idrequiredstring
kindrequiredone of: posts, voters, users, companies
statusrequiredone of: pending, running, complete, failed
rowsrequiredintegerRows written so far, or in total once complete.
errorrequiredstring or null
created_atrequiredstring (date-time)
completed_atrequiredstring (date-time) or null
expires_atrequiredstring (date-time) or nullWhen the file is deleted.
download_urlrequiredstring (uri) or nullSigned link to the CSV, valid for 15 minutes; call get_export again for a new one.
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "export_data", "arguments": {"kind":"<one of: posts, voters, users, companies>"} }

// Typed client
await carechannel.export_data({"kind":"<one of: posts, voters, users, companies>"});