# List AI agent assignments

Retrieves a list of AI agent assignments filtered by assignment type and optional resource ID.
            This allows querying which bots are active in specific scopes (global, forums, categories, channels).
            Returns an array of assignments matching the specified criteria.

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

Endpoint: GET /api/v1/ai-agents/assignments
Version: 1.0
Security: 

## Query parameters:

  - `resourceId` (string,null)
    Optional resource ID to filter assignments for a specific resource.
                Required for non-GLOBAL/GROUP assignments (e.g., forum_id for FORUM type, category_id for FORUM_CATEGORY type).
                Must be null or omitted for GLOBAL and GROUP assignment types.
    Example: "frm_xyz123"

  - `type` (string,null)
    Optional assignment type to filter by. Valid values: GLOBAL, GROUP, FORUM,
                FORUM_CATEGORY, GROUP_CHANNEL.
                Determines the scope where the AI agent operates.
    Enum: "GLOBAL", "GROUP", "FORUM", "FORUM_CATEGORY", "GROUP_CHANNEL"

## 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"

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation