Skip to content

Take the «May be out of date» mark off a case of an MCP tool

PUT
/v1/mcp-tools/{id}/cases/{caseId}/dismissal
curl --request PUT \
--url https://beta-api.plune.ai/v1/mcp-tools/example/cases/example/dismissal \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "snapshotNumber": 2 }'

For the snapshot whose change marked it, named by its number on the server: the mark stays off until a later snapshot changes the tool again. Only the dismissal is kept; the mark is computed. Whoever edits cases may (a person, or a write token without X-Plune-Session); a reader only sees the mark, and an agent is refused (403 agent_proposes). Taking it off twice is the first answer again. Logged as an update of the project.

id
required
string

The tool’s id

caseId
required
string

A live case linked to the tool

Media type application/json
object
snapshotNumber
required

The newest snapshot of the server, whose change marked the case

integer
>= 1
Example
{
"snapshotNumber": 2
}

The mark is off for that snapshot

Media type application/json
object
toolId
required
string
testCaseId
required
string
snapshotNumber
required
integer
dismissedBy
required
string
dismissedAt
required
string format: date-time
Example
{
"toolId": "6f1c2b3a-0000-4000-8000-000000002459",
"testCaseId": "6f1c2b3a-0000-4000-8000-0000000000c1",
"snapshotNumber": 2,
"dismissedBy": "6f1c2b3a-0000-4000-8000-0000000000a2",
"dismissedAt": "2026-11-13T09:00:00.000Z"
}

Invalid JSON or body

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid token or session

A reader, a read token, or an agent (agent_proposes: the catalog is not written by an agent yet)

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No such tool in your project, or the case is not one of its live cases

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

not_marked: the newest snapshot of the server is not that number, or its change does not mark the tool

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over