> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis.md).

# Auto Testing Policies APIs

Endpoints for adding, running, managing, and retrieving the results of automated policy tests in Guardian.

**Authentication:** Bearer token required (`Authorization: Bearer <token>`)

**Permission:** Standard Registry role required.

***

| Method   | Endpoint                                            | Description                                 | Auth Required |
| -------- | --------------------------------------------------- | ------------------------------------------- | ------------- |
| `POST`   | `/api/v1/policies/{policyId}/test`                  | Adds a new test to the policy               | Yes           |
| `GET`    | `/api/v1/policies/{policyId}/test/{testId}`         | Returns a policy test by ID                 | Yes           |
| `DELETE` | `/api/v1/policies/{policyId}/test/{testId}`         | Deletes the specified test                  | Yes           |
| `POST`   | `/api/v1/policies/{policyId}/test/{testId}/run`     | Starts running the policy test              | Yes           |
| `POST`   | `/api/v1/policies/{policyId}/test/{testId}/stop`    | Stops the running test                      | Yes           |
| `GET`    | `/api/v1/policies/{policyId}/test/{testId}/details` | Returns details of the most recent test run | Yes           |

## Endpoints

* [Adding New Test to the Policy](/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis/adding-new-test-to-the-policy.md)
* [Returning Policy Test by ID](/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis/returning-policy-test-by-id.md)
* [Deleting the Specified Test](/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis/deleting-the-specified-test.md)
* [Running the Policy Test](/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis/running-the-policy-test.md)
* [Stopping the Specified Test](/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis/stopping-the-specified-test.md)
* [Returning Details of the Most Recent Test Run](/guardian/standard-registry/policies/auto-testing-of-the-policies/auto-testing-policies-apis/returning-details-of-the-most-recent-test-run.md)