---
title: "Update a test (POST alias)"
method: POST
path: "/v1/tests/{id}"
tags: ["Tests"]
---

# Update a test (POST alias)

`POST /v1/tests/{id}`

Alias of `PUT /v1/tests/:id` for clients that cannot send PUT requests (some older HTTP libraries). Same body schema and behavior — see PUT for the canonical form.

## Path parameters

- `id` string, required

## Request body

- PostV1TestsId — Update a test (POST alias)
  - `test` object — Fields to update.
    - `name` string — Human-readable test name.
    - `success` boolean — true=pass, false=fail.
    - `status_message` string — Failure reason or arbitrary status text.
    - `extra` string — Arbitrary metadata.
    - `build` string — Build identifier to associate this test with.
    - `public` boolean — When true, makes the test publicly viewable via share URL.
  - `groups` string — Comma-separated string or array of tag/group names to attach to the test.

## Response `201`

Update a test (POST alias)

- TestingbotEntitiesAck — Testingbot_Entities_Ack model
  - `success` boolean, required — Whether the operation succeeded.
  - `errors` object, required — Validation errors keyed by field name. Only present when `success` is false.
  - `error` string, required — Single human-readable reason, used by the older endpoints in place of `errors`. Only present when `success` is false.

## Other responses

- `401` — Authentication required
- `403` — Account is read-only
- `404` — Test not found

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/eff607a49246/schema)