Added

New Editor role for agent subscribers

🏷️ API version: 2027-01

The AgentMembershipRole enum has a new value, EDITOR, next to OWNER and MEMBER. An EDITOR can use the agent and edit its configuration, but cannot share it, delete it, or change its state.

The role appears in two places in the schema:

  • The role field of AgentSubscriber, returned by the subscribers field on Agent.
  • The roles argument of Agent.subscribers, which now accepts EDITOR as a filter value.

What this means for your integration

AgentSubscriber.role can now return EDITOR. If your code handles AgentMembershipRole values exhaustively, for example with a switch statement or a strict enum in a generated client, add a case for EDITOR. Otherwise a subscriber with this role can fall through to an error or a default branch.

To list only editors, pass the new value in the roles argument:

query {
  agents {
    id
    subscribers(roles: [EDITOR]) {
      role
      type
    }
  }
}