sn_atf_author
Create ServiceNow ATF tests and suites, add tests to suites, or attach ordered steps from a verified catalog—without executing tests.
Instructions
Create ATF tests and suites, or add tests to a suite. Requires explicit table write grants. Rolls back confirmed inserts on failure; reports incomplete or uncertain writes. Supports a runtime-verified step catalog; script steps require atf.allowScriptSteps. Does not execute tests.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"profile": "<profile>"
},
"name": "sn_atf_author"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name required for create_test and create_suite | |
| steps | No | Ordered typed steps with validated inputs for add_steps | |
| action | Yes | Create tests/suites, add memberships or typed steps, or list supported step types | |
| active | No | Whether the new test or suite is active (default true) | |
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| description | No | Description for a new test or suite | |
| start_order | No | First membership order (default 100); existing memberships are unchanged | |
| test_sys_id | No | Test sys_id for add_steps | |
| suite_sys_id | No | Suite sys_id required for add_tests_to_suite | |
| test_sys_ids | No | Unique test sys_ids to add, in execution order (maximum 100) | |
| application_scope | No | Application scope sys_id or global for Global scope |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| metadata | Yes |