---
title: "Create a Result given data and UID"
method: POST
path: "/v1alpha2/parents/{parent}/results/{result_uid}"
tags: ["Results"]
---

# Create a Result given data and UID

`POST /v1alpha2/parents/{parent}/results/{result_uid}`

## Request

- Base URL: `https://localhost:8080/apis/results.tekton.dev`
- URL: `https://localhost:8080/apis/results.tekton.dev/v1alpha2/parents/{parent}/results/{result_uid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/docs/v1alpha2/parents/:parent/results/:result_uid/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- Result: Results are aggregators of Records, allowing users to refer to groups of Records as a single entity.
  - `annotations` object: Arbitrary user provided labels for the result.
  - `uid` string, required: server assigned identified of the Results
  - `name` string, required: User assigned identifier of the Result. Encodes Parent information.
  - `summary` RecordSummary: RecordSummary is a high level overview of a Record, typically representing a "root" record for a result. It includes type agonstic information so that UI's and other tools do not need to be aware of underlying types.
    - `record` string, required: The name of the Record this summary represents.
    - `type` string, required: Identifier of underlying data.
    - `status` 'UNKNOWN' | 'SUCCESS' | 'FAILURE' | 'TIMEOUT' | 'CANCELLED', required: Completion status of the Record.
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `annotations` object: Key-value pairs representing abitrary underlying record data that clients want to include that aren't covered by the above fields.
  - `created_time` string, date-time: DEPRECATED: Use create_time instead
  - `create_time` string, date-time: Server assigned timestamp for when the result was created.
  - `updated_time` string, date-time: DEPRECATED: Use update_time instead
  - `update_time` string, date-time: Server assigned timestamp for when the result was updated.
  - `id` string: DEPRECATED: use uid instead
  - `etag` string: This is etag for Results. If this is provided on update, it must match the server's etag.

## Response `200`

Default response

- Result: Results are aggregators of Records, allowing users to refer to groups of Records as a single entity.
  - `annotations` object: Arbitrary user provided labels for the result.
  - `uid` string, required: server assigned identified of the Results
  - `name` string, required: User assigned identifier of the Result. Encodes Parent information.
  - `summary` RecordSummary: RecordSummary is a high level overview of a Record, typically representing a "root" record for a result. It includes type agonstic information so that UI's and other tools do not need to be aware of underlying types.
    - `record` string, required: The name of the Record this summary represents.
    - `type` string, required: Identifier of underlying data.
    - `status` 'UNKNOWN' | 'SUCCESS' | 'FAILURE' | 'TIMEOUT' | 'CANCELLED', required: Completion status of the Record.
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `annotations` object: Key-value pairs representing abitrary underlying record data that clients want to include that aren't covered by the above fields.
  - `created_time` string, date-time: DEPRECATED: Use create_time instead
  - `create_time` string, date-time: Server assigned timestamp for when the result was created.
  - `updated_time` string, date-time: DEPRECATED: Use update_time instead
  - `update_time` string, date-time: Server assigned timestamp for when the result was updated.
  - `id` string: DEPRECATED: use uid instead
  - `etag` string: This is etag for Results. If this is provided on update, it must match the server's etag.

## Changes

- **2026-07-17** `278d1aed13c1`: 4 breaking, 2 warning, 2 info
  - added the new required request property `summary/end_time`
  - added the new required request property `summary/start_time`
  - removed the required property `summary/endTime` from the response with the `200` status
  - removed the required property `summary/startTime` from the response with the `200` status
  - …4 more
- **2025-09-18** `190f8ec31164`: 8 warning, 8 info
  - removed the request property `createTime`
  - removed the request property `createdTime`
  - removed the request property `updateTime`
  - removed the request property `updatedTime`
  - …12 more
- **2023-04-03** `8fb26784c7aa`: 4 breaking, 10 warning, 10 info
  - added the new required request property `summary/endTime`
  - added the new required request property `summary/startTime`
  - removed the required property `summary/end_time` from the response with the `200` status
  - removed the required property `summary/start_time` from the response with the `200` status
  - …20 more

[Operation history](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/changes/v1alpha2/parents/:parent/results/:result_uid/post.md)

---

[API](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification.md) - [All operations](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/revisions/278d1aed13c1?raw)