---
title: "Reserve Pixel Acre"
method: POST
path: "/pixel-acre/reservations"
---

# Reserve Pixel Acre

`POST /pixel-acre/reservations`

## Request

- Base URL: `https://apiacre.com`
- URL: `https://apiacre.com/pixel-acre/reservations`
- Auth: none required

## Request body

- PixelReservationRequest
  - `pixels` PixelDraft[], nullable: Explicit coordinates; every pixel may have its own colour, public note, and HTTPS URL.
    - `x` integer, required
    - `y` integer, required
    - `color` string, required
    - `note` string, nullable
    - `url` string, nullable
  - `blocks` PixelBlock[], nullable: Rectangular shortcuts; each block may have a different colour, public note, and HTTPS URL. Blocks are expanded atomically and may not overlap.
    - `x` integer, required
    - `y` integer, required
    - `color` string, required
    - `note` string, nullable
    - `url` string, nullable
    - `width` integer, required
    - `height` integer, required
  - `rules_version` string, required

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/apiacre/apis/api-acre.md) · [All operations](https://skmtc.dev/apiacre/apis/api-acre/llms.txt) · [OpenAPI document](https://skmtc.dev/apiacre/apis/api-acre/revisions/0ba942b920ad?raw)