---
title: "List AI Inbox Manager guidances"
method: GET
path: "/api/v2/ai-agents/inbox-manager/{id}/guidances"
tags: ["AIInboxManager"]
---

# List AI Inbox Manager guidances

`GET /api/v2/ai-agents/inbox-manager/{id}/guidances`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/ai-agents/inbox-manager/{id}/guidances`
- Auth: HTTP bearer

List the guidances configured for an AI Inbox Manager.


Requires one of the following scopes: `ai_agents:all`, `all:read`, `all:all`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `starting_after` string
- `status` 1 | 0

## Response `200`

The guidances configured for the AI Inbox Manager

- object
  - `items` AIAgentGuidance[], required: The list of guidances
    - `id` string, uuid, required: Unique identifier for the AI agent guidance
    - `organization_id` string, uuid, required: Organization ID
    - `agent_id` string, uuid, required: Associated AI Agent ID
    - `label` string, required: Label of the AI agent guidance
    - `instruction` string, required: Instruction text for the AI agent guidance. Should be empty string for BASICS category.
    - `status` 1 | 0, required: Status of the AI agent guidance
    - `category` 0 | 1 | 2 | 3 | 4, required: Category of the AI agent guidance
    - `basic_guidance_options` object: Basic guidance options (tone, length, etc.) - only for BASICS category
      - `tone` 'friendly' | 'neutral' | 'matter_of_fact' | 'professional' | 'humorous', required: Tone of voice for the AI agent
      - `length` 'concise' | 'standard' | 'thorough', required: Response length preference
    - `timestamp_created` string, required: Timestamp when the AI agent guidance was created
    - `timestamp_updated` string, required: Timestamp when the AI agent guidance was updated
  - `next_starting_after` string: Pass as `starting_after` to fetch the next page. Absent on the last page.

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

## Changes

- **2026-11-03** `c781051105a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/ai-agents/inbox-manager/:id/guidances/get.md)

---

[API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/3daaa5f6b0be?raw)