---
title: "Set Share Listing"
method: POST
path: "/assessments/{assessment_id}/share/listing"
tags: ["assessments"]
---

# Set Share Listing

`POST /assessments/{assessment_id}/share/listing`

## Request

- Base URL: `https://api.openproof.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openproof.io/assessments/{assessment_id}/share/listing`
- Auth: HTTP bearer

audit-b7: list (or unlist) this assessment in the public Verify directory. Off by default. Listing needs an active
share link, and a business has at most one listed assessment.

## Path parameters

- `assessment_id` string, required

## Request body

- ShareListingBody
  - `listed` boolean, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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