AlmondTill/G3N API

On this page

revokeConnectorGrant

mutation · in the family Your own session

What it does

Disconnect one AI assistant — your own connection, or any connection of an organization you own.

Disconnect ONE connected AI assistant by its id — the caller's own connection, or any connection of an organization the caller owns (AUTHZ/FORBIDDEN otherwise): the connection and the person's connector session are revoked at once; the assistant's very next call is refused and it must connect again. Answers the connection as it was.

What happens

The assistant’s access ends at once: its very next request is refused and it must be connected again to return.

Careful

Only your own connections, unless you own the organization. Cannot be undone — the assistant simply connects again if wanted.

Who may call it

Capability area: Your own session — What every signed-in person may do for themselves — their session, their profile and their own work.

Arguments

NameTypeRequiredNotes
idID ID!yesThe id of the record.

Returns

ConnectorGrant ConnectorGrant! — One connected AI assistant (a PERSON-bound connection — the assistant acts as the person who approved it, within their own role's access): the client, the access the person chose, the person, the organization, the instants.

Example request

mutation ExampleRevokeConnectorGrant($id: ID!) {
  revokeConnectorGrant(id: $id) {
    id
    clientId
    clientName
    access
    scope
    userId
    orgId
    createdAt
    expiresAt
  }
}

Variables:

{
  "id": "01900000-0000-7000-8000-37386ae00000"
}

Send it with the envelope naming the version: "extensions": {"at": {"version": {"name":"genesis","number":0}}}.

Example response

{
  "data": {
    "revokeConnectorGrant": {
      "id": "01900000-0000-7000-8000-37386ae00000",
      "clientId": "<client id>",
      "clientName": "Blue jeans",
      "access": "<access>",
      "scope": "<scope>",
      "userId": "01900000-0000-7000-8000-11f967df0000",
      "orgId": "01900000-0000-7000-8000-b0cf4f3c0000",
      "createdAt": "2027-01-31T00:00:00.000Z",
      "expiresAt": "2027-01-31T00:00:00.000Z"
    }
  },
  "extensions": {
    "at": {
      "callId": "01EXAMPLE-CALL-ID",
      "version": {
        "requested": {
          "name": "genesis",
          "number": 0
        },
        "serviced": {
          "name": "genesis",
          "number": 0
        }
      }
    }
  }
}

Errors this call can answer