# Set the status of a unit

Adresse: https://docs.athaus.ai/en/api/v1/referenz/set-unit-status

> Request, parameters, response and errors of POST /v1/listings/{externalListingId}/unit-status.

Type: Reference
Last updated: 2026-11-14

Sets the status of a listing that is a unit of a project, as the buttons of the project's unit list do: `free`, `option`, `reserved`, `sold` or `rented`. The answer is 200 with the listing. Any status other than `free` takes a running listing off the market (its `status` becomes `paused`); `reserved`, `sold` and `rented` also set the listing's own `reserved` and `closed` state. A repeat with the same status changes nothing. A listing that is not a unit of a project answers 409 `listing_not_unit`; a status that does not fit the project (`sold` in a rental project, `rented` in a project for sale) answers 409 `unit_status_invalid`. A change emits the event `unit.status_updated`. Needs write access to `listings`.

Requires the scope [`propose`](/en/api/v1/anmeldung#scopes).

## Request [#request]

```http
POST https://api.athaus.ai/v1/listings/{externalListingId}/unit-status
```

### Parameters [#parameters]

**Path**

| Name                | Type     | Required | Description                                                                                                                                                                                                                                                               |
| ------------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `externalListingId` | `string` | yes      | Your reference of the listing: the value of metadata.source.offererMarketingKey. A listing without one has its own listingId here, and the listingId always works in the path. 1 to 128 letters, digits, dots, underscores or hyphens, not starting or ending with a dot. |

**Header**

| Name              | Type     | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Athaus-Version`  | `string` | no       | Optional and carries nothing a client needs: the version is the path. Accepted when it says `v1` or `1`. Any other value is a 400 `api_version_unsupported`.                                                                                                                                                                                                                                                                         |
| `Idempotency-Key` | `string` | no       | Makes a retry safe: the same key with the same body returns the first answer and writes nothing twice. A random value of at least 128 bits, for example a UUID, 1 to 255 characters. The key is kept for 24 hours and scoped to the API key and this operation. The same key with a different body is a 422; while the first request still runs it is a 409. Only successful answers are kept: after an error the key is free again. |

### Request body [#request-body]

JSON with `Content-Type: application/json`. A field the API does not know is a `400`, and `errors[].name` names the field. The body is required.

| Field    | Type     | Description                                                                                                                                                                                    |
| -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `status` | `string` | Ours, not OpenImmo. A rental project knows free, option, reserved and rented; a project for sale knows free, option, reserved and sold. One of `free`, `option`, `reserved`, `sold`, `rented`. |

### Example [#example]

```bash
curl -X POST "https://api.athaus.ai/v1/listings/WE-12/unit-status" \
  -H "Authorization: Bearer ath_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"status":"reserved"}'
```

## Response [#response]

On success the status is `200` with `ListingResponse`.

### ListingResponse [#listingresponse]

| Field                                                          | Type                 | Description                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `listing`                                                      | `object`             | The listing as stored. data, metadata, contact and media are the OpenImmo 2.0 members; listingId, status, createdAt and updatedAt are our additive members (status: publication state in Athaus, closed means sold or let).                                                                               |
| `listing.data`                                                 | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.estateType`                                      | `string`             | One of `HOUSE`, `APARTMENT`, `PLOT`, `OFFICE`, `TRADING`, `GASTRONOMY_HOTEL`, `STORAGE_PRODUCTION`, `AGRICULTURE_FORESTRY`, `PARKING`, `SENIOR`, `PROJECT`, `MISCELLANEOUS`.                                                                                                                              |
| `listing.data.estateSubType`                                   | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.distributionType`                                | `string`             | One of `BUY`, `RENT`, `COMPULSORY_AUCTION`, `BUY_AUCTION`.                                                                                                                                                                                                                                                |
| `listing.data.location`                                        | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.postalcode`                             | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.city`                                   | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.street`                                 | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.houseNumber`                            | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.unit`                                   | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.staircase`                              | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.floorNumber`                            | `integer`            | -5 to 999.                                                                                                                                                                                                                                                                                                |
| `listing.data.location.entrance`                               | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.state`                                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.country`                                | `string`             | One of 249 values from the list in the standard.                                                                                                                                                                                                                                                          |
| `listing.data.location.geometry`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.location.showAddress`                            | `boolean`            | Default `true`.                                                                                                                                                                                                                                                                                           |
| `listing.data.location.locationNote`                           | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices`                                          | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.currency`                                 | `string`             | One of 180 values from the list in the standard. Default `EUR`.                                                                                                                                                                                                                                           |
| `listing.data.prices.buy`                                      | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.rent`                                     | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.compulsoryAuction`                        | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.buyAuction`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.brokerageFee`                             | `any`                |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.showPrice`                                | `boolean`            |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.priceNote`                                | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.prices.countrySpecific`                          | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.spaces`                                          | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.spaces.spaceMeasureUnit`                         | `string`             | One of `SQUARE_METER`, `SQUARE_INCH`, `SQUARE_FOOT`, `SQUARE_YARD`, `HECTARE`, `ACRE`. Default `SQUARE_METER`.                                                                                                                                                                                            |
| `listing.data.spaces.buildingFront`                            | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.kitchenSpace`                             | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.overallSpace`                             | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.usableFloorSpace`                         | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.spaceMax`                                 | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.spaceMin`                                 | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.plotSpace`                                | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.plotFront`                                | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.additionalSpace`                          | `number`             | 0 to 99999999.                                                                                                                                                                                                                                                                                            |
| `listing.data.spaces.residential`                              | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.spaces.commercial`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.conditions`                                      | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.conditions.buildState`                           | `string`             | One of `FIRST_TIME_USE`, `FIRST_TIME_USE_AFTER_REFURBISHMENT`, `MINT_CONDITION`, `MODERNISED`, `REFURBISHED`, `FULLY_RENOVATED`, `PARTLY_RENOVATED`, `NEED_OF_RENOVATION`, `WELL_KEPT`, `NEGOTIABLE`, `RIPE_FOR_DEMOLITION`, `PROJECTED`, `NO_INFORMATION`, `RESTRUCTURED`, `TO_RESTORE`, `TO_REFURBISH`. |
| `listing.data.conditions.ageState`                             | `string`             | One of `OLD`, `NEW`.                                                                                                                                                                                                                                                                                      |
| `listing.data.conditions.lastModernisation`                    | `integer`            |                                                                                                                                                                                                                                                                                                           |
| `listing.data.conditions.constructionStyle`                    | `string`             | One of `PREFABRICATED`, `SOLID`, `SOLID_PREFABRICATED`, `TIMBERHOUSE`, `WOOD_PREFABRICATED`, `UNSPECIFIED`.                                                                                                                                                                                               |
| `listing.data.conditions.yearOfConstruction`                   | `integer`            | 1000 to 3000.                                                                                                                                                                                                                                                                                             |
| `listing.data.energy`                                          | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.energy.energyType`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.energy.countrySpecific`                          | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features`                                        | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.accessibleFromStreet`                   | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.aircondition`                           | `string`             | One of `YES`, `PART`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                             |
| `listing.data.features.entranceHall`                           | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.floorCovering`                          | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.furnished`                              | `string`             | One of `PART`, `FULL`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                            |
| `listing.data.features.garden`                                 | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.gym`                                    | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.internet`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.lighting`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.mezzanine`                              | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.propertyOrientation`                    | `string`             | One of `NORTH`, `EAST`, `SOUTH`, `WEST`, `NORTH_EAST`, `SOUTH_EAST`, `SOUTH_WEST`, `NORTH_WEST`.                                                                                                                                                                                                          |
| `listing.data.features.receptionist`                           | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.security`                               | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.wheelchairUse`                          | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.wineCellar`                             | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.features.residential`                            | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.commercial`                             | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.parking`                                | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.features.plot`                                   | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.structure`                                       | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.structure.building`                              | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.structure.rooms`                                 | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.structure.commercial`                            | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.structure.parkingLots`                           | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.texts`                                           | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.texts.headline`                                  | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.texts.description`                               | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.texts.features`                                  | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.texts.extendedInformation`                       | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.texts.area`                                      | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management`                                      | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.isImmediatelyAvailable`               | `boolean`            |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.availableFrom`                        | `string (date)`      |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.availableUntil`                       | `string (date)`      |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.isForInvestment`                      | `boolean`            |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.heritageProtected`                    | `string`             | One of `YES`, `NO`, `NOT_APPLICABLE`.                                                                                                                                                                                                                                                                     |
| `listing.data.management.marketStatus`                         | `string`             | One of `SOLD`, `RENTED`, `REFERENCE`, `RESERVED`, `UNDER_OFFER`.                                                                                                                                                                                                                                          |
| `listing.data.management.projectStatus`                        | `string`             | One of `BUILDING_PERMISSION`, `COMMERCIAL_LAUNCH`, `CONSTRUCTION_START`, `UNDER_CONSTRUCTION`, `SHELL_WORKS`, `FINISHING_WORKS`, `LAST_CHANCE`, `PROJECT_ENDED`.                                                                                                                                          |
| `listing.data.management.marketLabel`                          | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.isRented`                             | `boolean`            |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.useFor`                               | `string`             | One of `LIVING`, `COMMERCIAL`, `MIXED`, `OFFICE`, `INDUSTRIAL`.                                                                                                                                                                                                                                           |
| `listing.data.management.isForHolidayRental`                   | `boolean`            |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.rent`                                 | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.management.compulsoryAuction`                    | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.countrySpecific`                                 | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.countrySpecific.de`                              | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.countrySpecific.fr`                              | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact`                                         | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.salutation`                              | `string`             | One of `Mr`, `Mrs`, `Miss`, `Ms`, `Mx`, `Sir`, `Dame`, `Dr`, `Cllr`, `Lady`, `Lord`.                                                                                                                                                                                                                      |
| `listing.data.contact.firstName`                               | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.lastName`                                | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.name`                                    | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.emailAddress`                            | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.phoneNumber`                             | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.mobilePhoneNumber`                       | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.imageURL`                                | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.userHomepage`                            | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.postalCode`                              | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.city`                                    | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.street`                                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.houseNumber`                             | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.country`                                 | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.preferredContactType`                    | `string`             | One of `ANONYMOUS`, `BY_PHONE`, `BY_EMAIL`, `OWN_WEBSITE`.                                                                                                                                                                                                                                                |
| `listing.data.contact.contactNote`                             | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.data.contact.displayedInformation`                    | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.links`                                           | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.data.links.externalLinks`                             | `object[]`           |                                                                                                                                                                                                                                                                                                           |
| `listing.data.links.virtualTours`                              | `object[]`           |                                                                                                                                                                                                                                                                                                           |
| `listing.metadata`                                             | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.metadata.source`                                      | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.metadata.source.offererMarketingKey`                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.metadata.source.offererEstateId`                      | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.metadata.source.offererEstateGroupId`                 | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.metadata.portalWebKey`                                | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact`                                              | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.salutation`                                   | `string`             | One of `Mr`, `Mrs`, `Miss`, `Ms`, `Mx`, `Sir`, `Dame`, `Dr`, `Cllr`, `Lady`, `Lord`.                                                                                                                                                                                                                      |
| `listing.contact.firstName`                                    | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.lastName`                                     | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.name`                                         | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.emailAddress`                                 | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.phoneNumber`                                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.mobilePhoneNumber`                            | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.imageURL`                                     | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.userHomepage`                                 | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.postalCode`                                   | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.city`                                         | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.street`                                       | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.houseNumber`                                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.country`                                      | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.preferredContactType`                         | `string`             | One of `ANONYMOUS`, `BY_PHONE`, `BY_EMAIL`, `OWN_WEBSITE`.                                                                                                                                                                                                                                                |
| `listing.contact.contactNote`                                  | `map<string>`        |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.displayedInformation`                         | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.displayedInformation.mainContactPerson`       | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.contact.displayedInformation.additionalContactPerson` | `object`             |                                                                                                                                                                                                                                                                                                           |
| `listing.media`                                                | `object[]`           |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].externalMediaId`                              | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].title`                                        | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].id`                                           | `string (uuid)`      | The id of the file in /files.                                                                                                                                                                                                                                                                             |
| `listing.media[].kind`                                         | `string`             | One of `photo`, `floor_plan`, `document`.                                                                                                                                                                                                                                                                 |
| `listing.media[].documentType`                                 | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].fileName`                                     | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].mimeType`                                     | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].sizeBytes`                                    | `integer`            |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].width`                                        | `integer`            |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].height`                                       | `integer`            |                                                                                                                                                                                                                                                                                                           |
| `listing.media[].contentUrl`                                   | `string`             | The address of the bytes; fetch it with the same API key.                                                                                                                                                                                                                                                 |
| `listing.userDefined`                                          | `object[]`           |                                                                                                                                                                                                                                                                                                           |
| `listing.userDefined[].name`                                   | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.userDefined[].value`                                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.userDefined[].utyp`                                   | `string`             | One of `string`, `integer`, `boolean`, `decimal`.                                                                                                                                                                                                                                                         |
| `listing.userDefined[].modus`                                  | `string`             |                                                                                                                                                                                                                                                                                                           |
| `listing.listingId`                                            | `string (uuid)`      |                                                                                                                                                                                                                                                                                                           |
| `listing.projectId`                                            | `string (uuid)`      | Present when the listing is a unit of a new-build project: the `projectId` of that project. Read-only; `POST /projects/{externalProjectId}/assign` moves a listing into a project.                                                                                                                        |
| `listing.status`                                               | `string`             | One of `draft`, `active`, `paused`, `reserved`, `closed`.                                                                                                                                                                                                                                                 |
| `listing.createdAt`                                            | `string (date-time)` |                                                                                                                                                                                                                                                                                                           |
| `listing.updatedAt`                                            | `string (date-time)` |                                                                                                                                                                                                                                                                                                           |

### Response headers [#response-headers]

| Header                | Description                                                                                                     |
| --------------------- | --------------------------------------------------------------------------------------------------------------- |
| `Request-Id`          | Identifies this request. Quote it in a support request.                                                         |
| `Athaus-Version`      | The API version of this response: v1.                                                                           |
| `Athaus-Release`      | The release of v1 that answered, for example 1.0. A label for support and changelogs; no request can select it. |
| `RateLimit-Policy`    | The quota policy of the bucket that applies.                                                                    |
| `RateLimit`           | Remaining quota and seconds until the bucket is full again.                                                     |
| `Idempotent-Replayed` | `true` when this is the stored answer to an earlier request with the same Idempotency-Key.                      |

## Errors [#errors]

Every error arrives as [problem details](/en/api/v1/fehler). Branch on `code`, not on `title` or `detail`.

| Status | Codes                                                                                                                  | Meaning                                                                                                     |
| ------ | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `400`  | [`api_version_unsupported`](/en/api/errors#api_version_unsupported), [`invalid_body`](/en/api/errors#invalid_body)     | Invalid request.                                                                                            |
| `401`  | [`unauthorized`](/en/api/errors#unauthorized)                                                                          | Missing or invalid API key.                                                                                 |
| `403`  | [`insufficient_permissions`](/en/api/errors#insufficient_permissions), [`plan_required`](/en/api/errors#plan_required) | The key lacks a right, or the plan does not include API access.                                             |
| `404`  | [`not_found`](/en/api/errors#not_found)                                                                                | Nothing under this ID.                                                                                      |
| `409`  | [`listing_not_unit`](/en/api/errors#listing_not_unit), [`unit_status_invalid`](/en/api/errors#unit_status_invalid)     | The request conflicts with the state of the resource (for example a duplicate), or with an idempotency key. |
| `413`  | [`payload_too_large`](/en/api/errors#payload_too_large)                                                                | The request body is larger than 512 KB.                                                                     |
| `415`  | [`invalid_input`](/en/api/errors#invalid_input)                                                                        | The request body is not JSON. Send `Content-Type: application/json`.                                        |
| `422`  | [`idempotency_key_reused`](/en/api/errors#idempotency_key_reused)                                                      | The idempotency key was already used with a different request body.                                         |
| `429`  | [`rate_limited`](/en/api/errors#rate_limited)                                                                          | Rate limit exceeded.                                                                                        |
| `500`  | [`internal_error`](/en/api/errors#internal_error)                                                                      | Server error.                                                                                               |
