Conviu

Update an existing export (data writer job): its name, schedule, output format, destination, compression, which items it exports, its "block export when…" guard conditions (blockWhen), or its source imports. Pass dataWriterJobUid plus ONLY the fields you want to change — everything else (including the full existing configuration) is preserved automatically.

edit_data_writer_job

WARNING: Modifies an export rule. First follow get_workflow(edit_export_rule). Pass only changed top-level metadata; omit `settings` for metadata-only edits. If settings changes, supply its complete input-valid branch rather than raw get output or a nested patch. The tool preserves omitted values (including the rule's conditions editing mode), sends core a full normalized replace, validates exact parent-job field keys, enforces the immutable group, and keeps BULK_EDIT conditions empty.

edit_data_writer_job_rule

Get configuration and status details of a single data source by UID. Protected connection details are omitted from the returned configuration.

get_data_source

List the supported data formats (XML, CSV, JSON, etc.), optionally filtered by direction, reader type, or object definition type. Returns the full matching set (name-ordered) so you can find a specific format and read its exact smallUid — it is not truncated. IMPORTANT: some formats are country-specific and share the SAME name (e.g. several "UPgates" entries that differ only by country); use the returned `country` field to pick the right one (e.g. country code SK vs PL) and take that entry's smallUid.

get_data_source_formats

Get import execution logs with timing and error details for a data source.

get_data_source_job_logs

List available reader types (connection methods) for importing data into Conviu. Each reader includes a configurationSchema describing the keys to put under "configuration.reader" when calling create_data_source/update_data_source with that readerType (the configuration is a composite { reader, formatter, import } object).

get_data_source_readers

List available writer types (output destinations) for exporting data from Conviu. Each writer includes a configurationSchema describing the keys to put in the "configuration" object when calling add_data_writer_job/edit_data_writer_job with that writerType.

get_data_source_writers

Get export job details including state, schedule, AI/translation flags, item count, output links, `fields` and `variables`. In `fields`, the map KEY is the full element path (segments joined by " > ") and each record reports `hasChildren` plus a `label` that is IDENTICAL to the key; rule SETTINGS take that key verbatim, never shortened to its last segment. A field in rule FQL has exactly TWO valid forms: `%variable%` (PREFERRED) — an exact `name` from `variables`, percent signs INCLUDED, reading the item source data; or `'FULL > PATH'` — an exact `fields` key in single quotes (key "SHOPITEM > EAN" becomes `'SHOPITEM > EAN'`) — reading the rendered output, only when the user asks about the finished feed or no variable fits. Anything else silently never matches. `list_data_queries` returns neither catalogue.

get_data_writer_job

Get recent export download activity for operational monitoring, including download time, status, and transferred traffic. Client IP addresses and user-agent strings are not returned.

get_data_writer_job_latest_download_logs

Get the most recent data feed validation result for a data writer job.

get_data_writer_job_latest_validation

Get export execution history with timing and error details.

get_data_writer_job_logs

Get single export rule details including conditionsType, typed settings, applicability dates, the parent job with its exact output `fields`, and the `variables` catalogue its conditions can filter on. Settings paths are exact `fields` map keys, never shortened to the last segment. A field in rule FQL has exactly TWO valid forms: `%variable%` (PREFERRED) — an exact `name` from `variables`, percent signs INCLUDED, reading the item source data; or `'FULL > PATH'` — an exact `fields` key in single quotes — reading the rendered output, only when the rule targets the finished feed or no variable fits. Anything else silently never matches. The `settings` output materializes null branches and output-only helpers, so never send it back verbatim. When editing metadata only, omit `settings` from edit_data_writer_job_rule and the tool safely projects the current configuration.

get_data_writer_job_rule

Get full detail of a specific data feed validation by its UID.

get_data_writer_job_validation

Return the full text of a Conviu help page by its path (as returned by search_documentation), for when a search passage is not enough and you need the complete page.

get_documentation_page

List all module jobs (data writer jobs, campaigns, pricing calculators, etc.) connected to a data source.

get_module_jobs_by_data_source

Returns key details about a Conviu organization: name, active status, subscription info, billing period, and data source presence. Provide either uid (UID32) or smallUid (UID10) to identify the organization.

get_organization

Returns the status of every Conviu module an organization uses (product import/export, pricing calculator, bidding, competition monitoring, marketplaces, PPC advertisement, …) — the same overview the Conviu dashboard shows. Use it to answer "how is my organization doing?", to spot which module needs attention, or to sweep several organizations for problems. Pass locale to get titles and messages in the user's language (whoami returns it). Each module reports: title (the human module name), status (an internal code — 'error' | 'warning' | 'success' | 'info' — describe it in plain words, never show the code itself), statusMessage and primaryMessages (ready-made human explanations of what is wrong), lastUpdatedAt, dataObjectDefinitionType, and route — the app page for that module or problem, as { name, parameters } where parameters carry ids such as uid, so a client can link the user straight to the affected import, export or campaign.

get_organization_modules

Fetch the step-by-step playbook for a multi-step Conviu task BEFORE you start it, so you collect exactly the right information, in the right order, every time. Call this FIRST — before any other tool — whenever the user wants to perform one of the available workflows. Available workflows: create_import (create a new data source / import), create_export (create a new export / data writer job from existing imports), create_export_rule (create a rewriting/filtering rule on an export), edit_import (change an existing data source / import), edit_export (change an existing export / data writer job), edit_export_rule (change an existing export rule), diagnose (find out why an import or export is not working and fix it).

get_workflow

List connected external accounts (Google, Shoptet, Upgates, Heureka, Kaufland, Allegro, etc.) for an organization. Use this to obtain the connectorAccountUid required by marketplace/API reader and writer configurations. Returns uid, name, valid, and connector { code, name, accountRequired }.

list_data_connector_accounts

List the data queries available as the SOURCE of an export (data writer job). Each existing import has a data query — pass the chosen ones' "uid" values as dataQueryUids when calling add_data_writer_job. Returns uid, name, type, itemCount and the backing dataSource (uid, active, state).

list_data_queries

List all data sources for an organization with optional filtering, sorting and pagination.

list_data_sources

List export rule summaries for a job, including UID, name, active state, execution position, rule group/type, conditions, creation time, and totalCount. Use get_data_writer_job_rule for typed settings and full rule details.

list_data_writer_job_rules

List all export jobs for an organization with their state, schedule, and item counts. Supports FQL filtering, sorting, and offset/limit pagination. Returns uid, name, state, active, schedule, lastWrittenAt, processArtificialIntelligence, processTranslation, itemCount, and totalCount.

list_data_writer_jobs

Lists data items (products, orders, or other supported object types) for a Conviu organization. Supports FQL filtering, sorting, and offset/limit pagination. Returns item id, dataSourceUid, approval status, manual flag, an explicit set of standard data fields, and totalCount. Unbounded custom data and calculated variable blobs are not returned.

list_items

Lists the Conviu organizations the currently authenticated user has access to. Supports an optional search string (matches name, or exact smallUid / uid), sorting (name, createdAt, active) and offset/limit pagination. Returns each organization's uid, smallUid, name and active status, plus totalCount.

list_organizations

Search the official Conviu help documentation (Czech) for how-to and conceptual questions about using Conviu — features, settings, step-by-step guides, troubleshooting. Returns the most relevant passages with their page title and public URL. Use this to ground product advice in the docs instead of guessing; use the data tools (not this) for the user's own imports, exports and items.

search_documentation

Enable or disable automatic imports for a data source. CAUTION: Disabling stops all scheduled processing for this source.

set_data_source_active

Enable or disable automatic export job execution. WARNING: Setting active=false stops all scheduled executions and deletes the current Conviu-hosted output file; FTP outputs are not deleted from the remote FTP server.

set_data_writer_job_active

WARNING: Enable or disable an export rule. Disabled rules are skipped during execution.

set_data_writer_job_rule_active

Test whether a source is accessible before creating a data source. This makes a real outbound request using the supplied reader type and supported settings.

test_data_source_readability

TRIGGERS an immediate data source import outside the regular schedule. Use for testing or urgent refreshes. This starts a real import job.

trigger_data_source

WARNING: Manually triggers immediate job execution outside the regular schedule. This starts a real export run.

trigger_data_writer_job

WARNING: Manually requests a data feed validation run for the specified data writer job.

trigger_data_writer_job_validation

Update an existing data source (import): its name, schedule, format, connection details (e.g. the feed URL), or import settings. Changes take effect on the next import. Pass organizationUid + dataSourceUid plus ONLY the fields you want to change — everything else (including the full existing configuration and any custom-format field mapping) is preserved automatically. Reader-config changes go under `reader` (e.g. { "url": "…" }), import-level changes under `import`.

update_data_source

Returns basic profile information about the currently authenticated Conviu user (email, name, locale). Takes no arguments.

whoami