---
title: "Propose a typed private Inbox view to the credential owner."
method: POST
path: "/api/v1/inbox/views"
tags: ["Inbox"]
---

# Propose a typed private Inbox view to the credential owner.

`POST /api/v1/inbox/views`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/inbox/views`
- Auth: HTTP bearer

Registered account-scoped agents may create pending proposals only. A proposal stays inactive until the human owner accepts it in the Inbox; agents cannot change configuration.

## Headers

- `X-Commentary-Workspace-Id` string
- `X-Correlation-Id` string

## Request body

- object
  - `name` string, required
  - `definition` object, required

## Response `201`

Successful response.

- object
  - `data` object

## Other responses

- `400`: The request was invalid.
- `401`: Authentication is required.
- `403`: The token or session does not have permission for this resource.
- `404`: The resource was not found.
- `409`: The pending proposal or active-view limit was reached.
- `429`: The request was rate limited.

---

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