INinstantly
AIInboxManager

List AI Inbox Manager guidances

Changed on

List the guidances configured for an AI Inbox Manager.

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

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

Path parameters

idstring uuid required
Example:0195b1a5-3b1d-7b6e-9c1a-2f7a4b0c1d2e

AI Inbox Manager ID

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring
Example:01956fbd-0eb1-72db-a565-82977a586084

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

status1 | 0
Example:1

Filter guidances by status

Response

The guidances configured for the AI Inbox Manager

next_starting_afterstring

Pass as starting_after to fetch the next page. Absent on the last page.

Example response

{
  "items": [
    {
      "id": "01a19e6d-5112-78b2-a4b9-25d6753c4d2e",
      "organization_id": "01a19e6d-5112-78b2-a4b9-25d7203d126c",
      "agent_id": "01a19e6d-5112-78b2-a4b9-25d88ee1b88e",
      "label": "Test AI Agent Guidance",
      "instruction": "This is an AI agent guidance instruction",
      "status": 1,
      "category": 1,
      "basic_guidance_options": {
        "tone": "professional",
        "length": "standard"
      },
      "timestamp_created": "2026-11-02T22:42:06.738Z",
      "timestamp_updated": "2026-11-02T22:42:06.738Z"
    }
  ],
  "next_starting_after": "01a19e6d-8571-7925-9652-dbcb9d9267af"
}

Changes