delete_org_admin_by_orgid_invitations_by_userid

Changes data · you confirm first Idempotent

Calls DELETE /api/org-admin/{orgId}/invitations/{userId} as the signed-in person · REST reference

Take back an invitation the organization sent and the invitee has not answered

With the caller's own token; requires admin.groups.members.remove in the organization. Every pending invitation of that person into the organization is stamped REMOVED. 404 when they hold none (never invited, already answered, or already taken back).

Arguments

ArgumentTypeDescription
orgIdpathstring (uuid)required
userIdpathstring (uuid)required

Example call

A client sends this over the MCP session; Claude and other agents build it for you. The values are placeholders — the shape is real.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_org_admin_by_orgid_invitations_by_userid",
    "arguments": {
      "orgId": "11111111-1111-4111-8111-111111111111",
      "userId": "11111111-1111-4111-8111-111111111111"
    }
  }
}
Confirmation
The client shows the person the exact request and waits. Nothing runs until they tick Make this change. See Reading and changing.

Result

On success (HTTP 200) the tool returns one text item holding the API's JSON, pretty-printed.

The invitation was taken back.

json
{
  "success": true,
  "data": {},
  "message": "string"
}

Fields

FieldTypeDescription
dataanyThe payload; absent when the operation returns nothing.
messagestring
successtrue

When it fails

A failed call returns isError: true with the API's message as text. A change the person declines, or lets time out, also comes back this way and nothing changes.

400

The request was malformed or failed a guard.

403

Authenticated, but the caller holds none of the required permissions.

404

No such resource — or none this caller may see.

What the model is shown

This is the tool exactly as the server lists it in tools/list. The description starts with the REST call it makes.

json
{
  "name": "delete_org_admin_by_orgid_invitations_by_userid",
  "description": "DELETE /api/org-admin/{orgId}/invitations/{userId} — With the caller's own token; requires `admin.groups.members.remove` in the organization. Every pending invitation of that person into the organization is stamped REMOVED. 404 when they hold none (never invited, already answered, or already taken back).\n\nThis changes data. The person is asked to confirm it before it runs, and nothing happens if they decline.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "orgId": {
        "type": "string"
      },
      "userId": {
        "type": "string"
      }
    },
    "required": [
      "orgId",
      "userId"
    ]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false
  }
}