---
title: "Apply a multi-doc YAML stream of v1alpha1 resources"
method: POST
path: "/v0/apply"
---

# Apply a multi-doc YAML stream of v1alpha1 resources

`POST /v0/apply`

## Query parameters

- `dryRun` boolean — Run validation without mutating the store. Defaults to false.

## Response `200`

OK

- ApplyResultsResponse
  - `results` ApplyResult[], nullable, required
    - `apiVersion` string
    - `error` string
    - `kind` string
    - `name` string, required
    - `namespace` string
    - `status` string, required
    - `tag` string

## Other responses

- `default` — Error

## Changes

> 53 revisions in range; 5 could not be searched.

- **2026-05-11** `9ed64a022233` — 1 warning, 1 info
  - removed the optional property `results/items/version` from the response with the `200` status
  - added the optional property `results/items/tag` to the response with the `200` status
- **2026-05-07** `1f7dac4e4622` — 3 breaking
  - the request body contentMediaType changed from `` to `application/octet-stream`
  - the response property `errors` became nullable for the status `default`
  - the response property `results` became nullable for the status `200`
- **2026-04-29** `68b97da7670c` — 1 breaking, 1 warning, 4 info
  - the response property `results/items/kind` became optional for the status `200`
  - deleted the `query` request parameter `force`
  - api operation id `apply` removed and replaced with `apply-batch`
  - api tag `apply` removed
  - …2 more
- **2026-04-17** `1f25a3f563c5` — 1 info
  - endpoint added
- **2026-03-02** `cd40eb4cf442` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/agentregistry-dev/apis/agentregistry/changes/v0/apply/post.md)

---

[API](https://skmtc.dev/agentregistry-dev/apis/agentregistry.md) · [All operations](https://skmtc.dev/agentregistry-dev/apis/agentregistry/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentregistry-dev/agentregistry/revisions/d34de2400d39/schema)