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

# List FlowAI projects

`GET /agent-project-service/projects`

## Request

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

Returns a paginated list of FlowAI Projects the current user has read access to.

## Query parameters

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

## Response `200`

Paginated list of FlowAI Projects

- AgentProjectServiceListProjectsResponse200
  - `message` string, required
  - `data` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaData, required
    - `items` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItems[], required
      - `_id` string, uuid, required
      - `iid` integer, required
      - `name` string, required
      - `description` string, required
      - `components` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItemsComponentsItems[], required
        - `type` 'agent', required
        - `reference` string, uuid, required
      - `createdBy` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItemsCreatedBy, required
        - `_id` string, required
        - `username` string, required
        - `provenance` string, required
      - `created` string, date-time, required
      - `lastUpdatedBy` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItemsLastUpdatedBy, required
        - `_id` string, required
        - `username` string, required
        - `provenance` string, required
      - `lastUpdated` string, date-time, required
      - `members` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItemsMembersItems[], required
        - union
          - AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItemsMembersItems0
            - `type` 'account', required
            - `reference` string, required
            - `role` 'owner' | 'editor' | 'viewer', required
            - `username` string, required
            - `provenance` string, required
          - AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataItemsItemsMembersItems1
            - `type` 'group', required
            - `reference` string, required
            - `role` 'owner' | 'editor' | 'viewer', required
            - `name` string, required
            - `provenance` string, required
    - `metadata` AgentProjectServiceProjectsGetResponsesContentApplicationJsonSchemaDataMetadata, 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/projects/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)