List Kiwi products (the TestRail 'project' equivalent). Filter dict optional.

List product versions. Typical filter: {"product": }.

List builds. Typical filter: {"version__product": } or {"version": }.

List test-case categories for a product (closest thing to TestRail sections). Typical filter: {"product": }.

List components. Typical filter: {"product": }.

List tags (the TestRail 'labels' equivalent). Filter e.g. {"name__startswith": "reg"}.

List test-case priorities and their ids.

List Kiwi users. Filter e.g. {"username": "sqa1"} or {"email__icontains": "acme.com"}. Requires the 'auth.view_user' permission on your Kiwi account; without it Kiwi returns error -32098 ("Authentication failed").

List TestExecution statuses (PASSED / FAILED / BLOCKED / ...) with their ids. Needed before updating an execution result.

List TestCase statuses (CONFIRMED / PROPOSED / ...) with their ids.

List test-plan types (Unit / Integration / Function / ...) with their ids.

List product classifications with their ids.

Search test cases. query is a Kiwi ORM filter dict. Common keys: {"plan": }, {"category__product": }, {"summary__icontains": "data usage"}, {"case_status__name": "CONFIRMED"}.

Fetch one test case by id, optionally with its comments, custom properties and attachment list.

Create a test case. values must include at least: summary, category_id (or category), priority_id (or priority), case_status_id (or case_status). Optional: text, notes, is_automated, script, extra_link, requirement, default_tester_id. Returns the created case.

Update one test case. values is a partial field dict (e.g. {"summary": "...", "text": "...", "case_status_id": 2}).

Apply the same values patch to many cases (mirrors TestRail update_cases). Runs one TestCase.update per id and reports per-id success/failure.

Permanently delete test cases matching an ORM filter dict. DESTRUCTIVE. Pass e.g. {"id": 123} or {"id__in": [1,2,3]}.

Return the change history for a test case.

Add a comment to a test case.

Attach a tag (by name) to a test case. The tag is created if it does not exist.

Attach a component (by name) to a test case.

Attach a file to a test case. Provide base64-encoded content.

Bulk-export full text of test cases matching query, flattened for RAG / review (id, summary, category, priority, status, text, notes). Mirrors TestRail export_cases_for_rag.

Search test plans. query common keys: {"product": }, {"name__icontains": "regression"}, {"is_active": true}.

Create a test plan. values needs: name, text, product_id (or product), product_version_id (or product_version), type_id (or type). Optional: parent_id, is_active, extra_link.

Update a test plan with a partial field dict.

Link an existing test case to a test plan.

Unlink a test case from a test plan.

Attach a tag (by name) to a test plan.

Search test runs. query common keys: {"plan": }, {"build__version__product": }, {"summary__icontains": "trip"}, {"stop_date__isnull": true} (still open).

Create a test run. values needs: summary, plan_id (or plan), build_id (or build), manager_id (or manager). Optional: notes, default_tester_id, planned_start, planned_stop.

Update a test run with a partial field dict (e.g. {"stop_date": "2026-09-08 17:00:00"}).

Permanently delete test runs matching an ORM filter dict. DESTRUCTIVE. Pass e.g. {"id": 42}.

Add a test case to a run. This creates the TestExecution rows for that case.

Remove a test case (and its executions) from a run.

List the test cases currently in a run.

Attach a tag (by name) to a test run.

Attach a file to a test run. Provide base64-encoded content.

Search test executions (results). query common keys: {"run": }, {"run": , "case": }, {"status__name": "FAILED"}, {"tested_by__username": "sqa1"}.

Update one execution. values e.g. {"status_id": 2} (see kiwi_get_execution_statuses), or {"tested_by_id": 5, "stop_date": "2026-09-08 16:30:00"}.

Record results for many cases in one run (mirrors TestRail add_results_for_cases). For each item, finds the execution for {run_id, case_id}, sets its status, and optionally adds a comment. status may be a status id (number) or name (string).

Add a comment to a test execution.

Get the comments on a test execution.

Attach an external URL (bug link, evidence) to a test execution.

List external links attached to a test execution.

Return the change history for a test execution.

Call ANY Kiwi JSON-RPC method directly. method e.g. "TestCase.filter", "TestPlan.tree", "Bug.report". params is the POSITIONAL argument array Kiwi expects (usually a single dict for *.filter, or [id, {patch}] for *.update). Unguarded — you are responsible for correct method + params. Full method list: https://kiwitcms.readthedocs.io/en/latest/modules/tcms.rpc.api.html

Generic delete: calls .remove with the given ORM filter dict. DESTRUCTIVE. model e.g. "TestCase", "TestRun", "TestExecution", "Tag". query e.g. {"id": 5} or {"id__in": [1,2,3]}.