Added
New Editor role for agent subscribers
November 3rd, 2026
🏷️ 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
rolefield ofAgentSubscriber, returned by thesubscribersfield onAgent. - The
rolesargument ofAgent.subscribers, which now acceptsEDITORas 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
}
}
}