list_inbox), filtered for the place the caller is in: a project’s postas plus postas without a project. Read-only.
Query parameters
string
Current project, for example the repository folder name. Compared trimmed and lowercase. Without it, postas of every project are included.
string
default:"unseen"
Which postas without a project to include:
unseen: only those stillopen, so a general note doesn’t come back every time after you’ve read it.all: every pending one.none: none.
string
default:"text"
text for agent context, or json.integer
default:"10"
1 to 20.
string
required
Bearer pst_.... See Authentication.Responses
Text format
Built to be added to an agent’s context, as the session hook does:- Always wrapped in
<posta-inbox untrusted="true">, even when every posta is your own. - The header says how many are pending and, with
project, how many belong to it. - Capped at about 2,000 characters. When postas don’t fit, or exceed
limit, the last line is- … N more: use LePosta's list_inbox tool to see them. - Empty body with
200when there is nothing to show.
JSON format
object[]
Newest first, up to
limit.integer
How many postas match in total, including those beyond
limit.Errors
400 with a plain-text message for an invalid project, general, format or limit; 401 with an empty body for a bad token. See status codes.