---
title: "Update clearance of places"
method: POST
path: "/places/clearance"
tags: ["Entries/Places"]
---

# Update clearance of places

`POST /places/clearance`

Update the clearance of multiple places on behalf of the
requesting organization.

Returns the number of created/updated clearance records.

If the given revision matches the current revision of that place
then any pending clearance is deleted. Otherwise clearance will
remain pending with the given revision stored as the new last
cleared revision, i.e. any pending clearance is replaced.

Requests must include the API token of the organization.

## Request body

- ClearanceForPlace[]
  - `place_id` string, required — Identifier of a resource
  - `cleared_revision` integer — A revision number

## Response `200`

Successful response

- ResultCount
  - `count` integer, required

## Other responses

- `401` — Access token is missing or invalid or the user has insufficient permission

## Changes

- **2020-12-21** `db28fc148796` — 1 breaking
  - the `items/cleared_revision` request property type/format changed from `integer`/`i64` to `integer`/`int64`
- **2020-08-13** `ddfd4e39c98d` — 2 breaking
  - the `items/cleared_revision` request property type/format changed from `integer`/`int64` to `integer`/`i64`
  - the `count` response's property type/format changed from `integer`/`int64` to `number`/`i64` for status `200`

[Change history](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/changes/places/clearance/post.md)

---

[API](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api.md) · [All operations](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kartevonmorgen/openfairdb-api/revisions/4c454390b099/schema)