Skip to content

Another project or right for a connection

PATCH
/v1/mcp-connections/{id}
curl --request PATCH \
--url https://beta-api.plune.ai/v1/mcp-connections/example \
--header 'Content-Type: application/json' \
--cookie plune_session=<plune_session> \
--data '{ "scope": "read" }'

In force from the assistant’s next call; no new consent and no new token. The same rules as a new connection: a project the person is in, read only from a reader, the plan of the project. 30 a minute a person. The signed-in session alone (an API token gets 401): a token, an assistant’s own included, can neither grant a connection nor widen one. Mounted only where the remote MCP server is switched on (MCP_PUBLIC_URL).

id
required
string

The connection id.

Media type application/json

At least one of the two.

object
projectId
string
scope
string
Allowed values: read write
Example
{
"scope": "read"
}

The connection as it now is

Media type application/json
object
id
required
string
clientName
required
string
clientKind
required

registered: the client registered itself, its name is unverified.

string
Allowed values: metadata registered
redirectHost
required
string
projectId
required
string
scope
required
string
Allowed values: read write
createdAt
required
string format: date-time
lastUsedAt
required

Moves when tokens are issued, so at most an hour behind the last call.

string format: date-time
idle
required

Not used for 90 days: it can no longer refresh, and stays listed until it is revoked.

boolean
Example
{
"id": "0b0f6a52-0e0f-4d0e-9d0a-5a1c5f6e7a10",
"clientName": "Assistant",
"clientKind": "registered",
"redirectHost": "assistant.example",
"projectId": "u-shop::default",
"scope": "read",
"createdAt": "2026-11-21T09:00:00.000Z",
"lastUsedAt": "2026-11-21T09:00:00.000Z",
"idle": false
}

The body is not {projectId?, scope?} with at least one of them

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

No / invalid session

reader_grants_read_only, or the plan does not include the remote MCP server

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

No such connection of this person, or the person is not in the project

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