Get Recent Agents

GET

/v2/api/agent/recent

Fetches a list of recent agents. The number of agents returned can be limited
using the optional query parameter limit. If limit is not specified,
a default number of 20 agents will be returned.

For more detailed information about agent, refer to the Agent Guide.

📝 Note: "Assistant" is another name for "Agent".

Request

Query Params

Header Params

Responses

🟢200OK

application/json

Successful response with a list of recent agents.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https:///v2/api/agent/recent?limit' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "Recent Agent fetched successfully",
    "data": [
        {
            "id": 2239,
            "agent": {
                "id": 1469,
                "user": {
                    "id": 16,
                    "email": "[email protected]",
                    "first_name": "user",
                    "last_name": "Nasir",
                    "organization": 1
                },
                "agent_type": {
                    "id": 1,
                    "created_by": "System",
                    "created_on": "2024-04-17T23:10:22.313394Z",
                    "modified_by": "[email protected]",
                    "modified_on": "2024-04-17T23:10:22.313414Z",
                    "name": "QnA",
                    "description": ""
                },
                "instructions": [
                    {
                        "id": 11369,
                        "instruction": "abc",
                        "is_deleted": false,
                        "created_by": "[email protected]",
                        "created_on": "2025-03-25T23:19:49.075545Z",
                        "agent": 1469
                    }
                ],
                "project": {
                    "id": 372,
                    "project_name": "userTestProject1",
                    "team": {
                        "id": 243,
                        "team_name": "usertestTeam1"
                    }
                },
                "connected_tool_names": [
                    "Rag Tool"
                ],
                "tags": [],
                "character_voice": null,
                "agent_name": "VocabCheckerss",
                "industry_area": "",
                "domain": "Enhance English vocabulary by offering definitions, synonyms, antonyms, and example sentences.",
                "sample_q1": 123,
                "sample_q2": "",
                "sample_q3": "",
                "prefix_prompt": "You are an AI assistant who helps users improve their English vocabulary by providing definitions, synonyms, antonyms, and example sentences for words.",
                "alias": "[email protected]",
                "is_active": false,
                "is_deleted": false,
                "created_by": "[email protected]",
                "created_on": "2025-03-17T20:35:52.680993Z",
                "agent_image": "https://storageaccountdevenv001.blob.core.windows.net/dev-dall-e-images/VocabChecker_716d1779-4065-4590-8c99-3ff895bd993cAwesome idea.png",
                "access": "Only team",
                "status": "Live",
                "caching_enabled": false,
                "chunk_count": 32,
                "attachment_chunk_count": 3,
                "attachment_chunking": false,
                "react_enabled": true,
                "react_max_iteration_count": 50,
                "llm_config": 8,
                "cloned_from": null
            },
            "user": {
                "id": 16,
                "email": "[email protected]",
                "first_name": "user",
                "last_name": "Nasir",
                "organization": 1
            },
            "created_on": "2025-04-03T19:16:35.868707Z"
        }
    ]
}

Edit Agent

Create Recent Agent