Skip to main content

ConnectedAgent

One AI agent connected over MCP (its agent grant).

type ConnectedAgent {
  id: ID!
  ownerID: String!
  userID: String!
  name: String!
  access: AgentGrantAccess!
  createdAt: Time!
  lastUsedAt: Time
  revokedAt: Time
}

Fields​

ConnectedAgent.id ● ID! non-null scalar​

ConnectedAgent.ownerID ● String! non-null scalar​

ConnectedAgent.userID ● String! non-null scalar​

The person whose authority the agent uses.

ConnectedAgent.name ● String! non-null scalar​

The person's label for the agent.

ConnectedAgent.access ● AgentGrantAccess! non-null enum​

ConnectedAgent.createdAt ● Time! non-null scalar​

ConnectedAgent.lastUsedAt ● Time scalar​

ConnectedAgent.revokedAt ● Time scalar​

Set once the grant is revoked; a revoked agent's calls are refused.

Returned By​

createAgentGrant mutation ● myAgentGrants query ● orgAgentGrants query ● revokeAgentGrant mutation ● revokeOrgAgentGrant mutation