List connected agents

connectedAgents(input: AgentWorkersInput!): ConnectedAgentList!

Requires project.runtime.manage.

Arguments

ArgumentTypeRequired
inputAgentWorkersInput!Yes

Input fields

input

AgentWorkersInput

FieldTypeRequired
projectReferenceStringNo

Response

Returns ConnectedAgentList!. Open the type for its fields and nested types.

FieldTypeDescription
data[ConnectedAgent!]!The project's connected agents: every push runtime service first, then at most the 50 most recently updated pull workers, with no continuation for the rest.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query ConnectedAgents($input: AgentWorkersInput!) {
  connectedAgents(input: $input) {
    data {
      id
      projectId
      agentId
      status
      createdAt
    }
  }
}
json
{
  "input": {
    "projectReference": "example-project"
  }
}