> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Append result

> Record a result for an execution.

Appends a result to an execution. A result is never changed afterwards. To correct one, use `POST /api/v1/test-management/results/{id}/correct` with a reason.

> [!NOTE]
>
> The token needs the `tests:write` scope, and its owner needs to be allowed to execute tests in the project. The cycle must be open.

## Path parameters

**id** `string` *required*

The ID of the execution.

## Request body

**category** `string` *required*

`PASSED`, `FAILED`, `BLOCKED`, `SKIPPED`, `IN_PROGRESS` or `NOT_RUN`.

**stepOrder** `number`

The step the result is for. Omit it for the verdict of the whole test.

**comment** `string`

A note from the tester.

**actualResult** `string`

What happened instead of the expected result.

**clientResultId** `string`

An ID you choose, 8 to 100 characters. Sending the same ID again answers `200` with the stored result instead of recording a second one.

**durationMs** `number`

How long the test took, in milliseconds.

## Response

Returns the stored result with status `201`, or `200` when `clientResultId` was already used.

```bash cURL theme={"dark"}
curl -X POST "https://your-collabase.ch/api/v1/test-management/executions/exe_123/results" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{ "category": "FAILED", "comment": "Payment page returns 500", "clientResultId": "build-4711-exe-123" }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.