Scenarios, knowledge and test data | TaloTrace Documentation

`scenarios`

Discover flows in an app, then list, write and organise its scenarios and test plans.

Annotations: can change or delete data.

`scenarios create`

Write new scenarios for an app.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`scenarios`	`array of ScenarioInput`	yes
`suite_id`	`string \| null`	no
`claim_mids`	`array of string`	no

`scenarios create_suite`

Create a test plan from existing scenarios.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`name`	`string`	yes
`scenario_ids`	`array of string`	yes

`scenarios delete`

Delete a scenario.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`scenario_id`	`string`	yes

`scenarios discovery_status`

Check how far a flow discovery has got.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`request_id`	`string`	yes

`scenarios list`

List an app’s scenarios, or those of one test plan.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`suite_id`	`string \| null`	no
`limit`	`integer`	no
`offset`	`integer`	no

`scenarios list_flows`

List the flows of a project.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.

`scenarios list_suites`

List an app’s test plans.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes

`scenarios set_suite`

Replace the scenarios of a test plan.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`suite_id`	`string`	yes
`scenario_ids`	`array of string`	yes

`scenarios start_flow_discovery`

Ask TaloTrace to explore the app and find its flows.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`language`	`string`	yes
`request`	`string`	no
`account_ids`	`array of string`	no
`constraints`	`string`	no
`device_profile`	`string`	no
`request_id`	`string`	yes

`scenarios update`

Change a scenario.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string`	yes
`scenario_id`	`string`	yes
`title`	`string \| null`	no
`goal`	`string \| null`	no
`preconditions`	`array of string \| null`	no
`setup_steps`	`array of string \| null`	no
`steps`	`array of Step \| null`	no
`requirement`	`ScenarioRequirement \| null`	no
`needs`	`array of Need \| null`	no
`applies_to`	`"all" \| array of Configuration \| null`	no

`knowledge`

Read the current product rules, their sources and versions, and export them as Markdown.

Annotations: reads only.

`knowledge claims`

Read the recorded product facts of a feature.

Argument	Type	Required	What it is
`limit`	`integer`	no
`after_mid`	`string \| null`	no
`feature_mid`	`string \| null`	no
`project_id`	`string`	yes	The project the call is about.
`version_id`	`string`	yes

`knowledge export`

Export a feature’s facts as Markdown.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`version_id`	`string \| null`	no
`feature_mid`	`string \| null`	no

`knowledge read`

Read the current product rules.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.

`knowledge run_context`

Read the product rules a run used.

Argument	Type	Required	What it is
`limit`	`integer`	no
`after_analysis_id`	`string \| null`	no
`scenario_run_id`	`string \| null`	no
`project_id`	`string`	yes	The project the call is about.
`run_id`	`string`	yes

`knowledge sources`

List where the product rules came from.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string \| null`	no
`origin`	`SourceOrigin \| null`	no

`knowledge versions`

List the versions of the product rules.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`limit`	`integer \| null`	no
`before_version`	`integer \| null`	no

`test_data`

Read test data, get an upload link for a file and add an item.

Annotations: can change or delete data.

`test_data create`

Add a test data item.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`item`	`CreateTestDataItemRequest`	yes
`request_id`	`string`	yes

`test_data list`

List test data items.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`app_id`	`string \| null`	no
`category`	`ItemCategory \| null`	no
`cursor`	`string \| null`	no

`test_data read`

Read one test data item.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`item_id`	`string`	yes

`test_data upload_link`

Get a link to upload a test file.

Argument	Type	Required	What it is
`project_id`	`string`	yes	The project the call is about.
`upload`	`TestDataUploadLinkRequest`	yes