---
title: "List intents"
method: GET
path: "/public/v1/agents/{agentId}/intents"
tags: ["Intents"]
---

# List intents

`GET /public/v1/agents/{agentId}/intents`

Lists agent intents. Requires a USER API key.

## Path parameters

- `agentId` string, required

## Query parameters

- `filterText` string
- `includeUsedStatus` union
  - boolean
  - string

## Response `200`

Paginated intents

- object
  - `count` number
  - `pageSize` number, required
  - `pageNum` number
  - `totalPages` number
  - `cursor` number
  - `results` Intent[], required
    - `id` number, required
    - `name` string, required
    - `description` string, nullable
    - `createdAt` string, nullable, required
    - `updatedAt` string, nullable, required
    - `status` 'ACTIVE' | 'DELETED', required
    - `assistantId` string, required
    - `phrases` object[]
      - `id` number, required
      - `phrase` string, required
    - `flowId` number, nullable
  - `paginationType` 'offset' | 'cursor'
  - `nextCursor` union
    - string
    - number
    - object, nullable

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/revisions/9d33b6aad674/schema)