Return the authenticated Clutter user for the configured API key.

Your Clutter API usage (request counts by route) over a rolling window + the daily quota.

List all of your Clutter projects (top-level tenant containers).

Create a new Clutter project. Returns the project (with its id).

List the synthetic organisations in a project.

Start building a synthetic organisation from a prompt. Returns 202 with an orgId. The build runs in the background (minutes) — then poll get_org, or call wait_for_org to block until ready. Omit projectId to auto-create a project (named after the generated company) — the simplest path.

Get an organisation including its full org.json structure. Check org.status.

Poll an org until its build reaches a terminal state (ready/failed) or the timeout. Returns the final org summary.

Ask a grounded natural-language question about an organisation (synchronous answer).

Delete an organisation and ALL its runs/artefacts (S3 + DB). Irreversible.

List the generation runs under an organisation.

Launch a generation run. Returns 202 with a runId — poll get_run or call wait_for_run. kind + params: • doc_generator → { prompt, doc_number (≤300), file_types:[docx|pdf|xlsx|eml|jpg], structure:'flat'|'nested', target_system?, allow_underscores? } • data_generator → { prompt, row_count (≤2000), data_format:'xlsx'|'csv'|'json', data_fields?, target_system? } • doc_metadata_gen → { sourceRunId (a completed doc_generator run), data_format, data_fields?, target_system? }

Get a run's status + progress counts. Poll this until status is terminal.

Poll a run until it reaches a terminal state (complete/partial/failed) or the timeout. Returns the final run status.

List the documents generated by a run (title, format, folderPath, status).

Get a short-lived presigned download URL for a single generated document.

Start building a single ZIP of all of a run's documents. Poll get_zip_url after.

Get a presigned download URL for a run's ZIP (409 until the build is ready).

Delete a run and its artefacts (S3 + DB). Leaves the parent org intact. Irreversible.