# List group AI agent assignments

RBAC:
- requires ANY of GroupAIAgents.Read, GroupAIAgents.Manage

Endpoint: GET /api/v1/groups/{groupId}/ai-agents/assignments
Version: 1.0
Security: 

## Query parameters:

  - `resourceId` (string,null)

  - `type` (string,null)
    Assignment scope/type that determines where an AI agent operates.
        - GLOBAL: Bot operates platform-wide across all content
        - GROUP: Bot operates within a specific group
        - FORUM: Bot operates within a specific forum
        - FORUM_CATEGORY: Bot operates within a specific forum category
        - GROUP_CHANNEL: Bot operates within a specific group channel
    Enum: "GLOBAL", "GROUP", "FORUM", "FORUM_CATEGORY", "GROUP_CHANNEL"

## Path parameters:

  - `groupId` (string, required)
    The unique identifier of the group
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 200 fields (application/json):

  - `assignmentId` (string, required)
    Unique TypeId for this assignment
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `agentId` (string, required)
    TypeId of the bot user assigned. References a user with isBot=true.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `assignmentType` (string, required)
    Assignment type determining where the bot operates.
            Valid values: GLOBAL, GROUP, FORUM, FORUM_CATEGORY, GROUP_CHANNEL
    Enum: "GLOBAL", "GROUP", "FORUM", "FORUM_CATEGORY", "GROUP_CHANNEL"

  - `resourceId` (string,null)
    TypeId of the specific resource this assignment is scoped to.
            Null for GLOBAL assignments.
            Contains forum_id for FORUM, category_id for FORUM_CATEGORY, channel_id for GROUP_CHANNEL assignments.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `groupId` (string,null)
    TypeId of the group this assignment belongs to.
            Present for group-scoped assignments (GROUP, FORUM, FORUM_CATEGORY, GROUP_CHANNEL).
            Null for GLOBAL assignments.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `createdAt` (string, required)
    ISO 8601 timestamp when this assignment was created
    Example: "2022-03-10T16:15:50Z"

  - `updatedAt` (string, required)
    ISO 8601 timestamp when this assignment was last updated
    Example: "2022-03-10T16:15:50Z"