---
title: "List operable agents"
method: GET
path: "/agent-project-service/operable-agents"
tags: ["Agent Project Service"]
---

# List operable agents

`GET /agent-project-service/operable-agents`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/agent-project-service/operable-agents`
- Auth: none declared

Returns a paginated list of Agents the current user can operate — either via write access to the parent project or membership in the agent's operators array.

## Query parameters

- `limit` integer
- `skip` integer
- `sort` 'name' | 'created' | 'lastUpdated'
- `order` '1' | '-1'

## Response `200`

Paginated list of operable Agent Definitions

- AgentProjectServiceListOperableAgentsResponse200
  - `message` string, required
  - `data` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaData, required
    - `items` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItems[], required
      - `_id` string, uuid, required
      - `name` string, required
      - `description` string, required
      - `instructions` string, required
      - `inputSchema` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItemsInputSchema, required
      - `provider` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItemsProvider, required
        - `profile` string, uuid, required
        - `model` string, uuid, required
        - `lastKnownProfileName` string, required
        - `lastKnownModelName` string, required
      - `operators` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItemsOperatorsItems[], required
        - `_id` string, required
        - `name` string, required
        - `provenance` string, required
      - `namespace` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItemsNamespace, required
        - `type` 'flowai_project', required
        - `_id` string, uuid, required
        - `name` string, required
      - `tools` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItemsToolsItems[], required
        - `referenceId` string, required
        - `lastKnownName` string, required
        - `decoratorId` string
      - `skills` AgentProjectServiceOperableAgentsGetResponsesContentApplicationJsonSchemaDataItemsItemsSkillsItems[], required
        - `skillId` string, required
        - `version` integer, required
        - `latest` boolean, required
        - `lastKnownName` string, required
    - `skip` integer, required
    - `end` integer, required
    - `count` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `previous` string, nullable, required
    - `next` string, nullable, required

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Agent Project Service` added
  - api tag `agentProjectService` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/agent-project-service/operable-agents/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)