7en.ai

Navigation

agent

Agent ObjectCreate AgentUpdate AgentDelete AgentList All Agents

api reference

IntroductionError handling

agent

Agent ObjectCreate AgentUpdate AgentDelete AgentList All Agents

api reference

IntroductionError handling

List All Agents

Retrieve a list of all AI agents associated with the authenticated user.

Overview

The List All Agents endpoint allows you to fetch all agents created by the user, including their configurations and metadata. This is useful for managing and reviewing all agents in your account.

Parameters

Request Header

Authorization

api key

Api key generated from 7en.i platform. Example: Api-Key 43NKLN3LKN4nlkn

Best Practices

  • Pagination: For large numbers of agents, consider implementing pagination by adding query parameters like ?page=1&limit=10 (if supported by the API).
  • Caching: Cache the response to reduce API calls if the agent list doesn't change frequently.
  • Error Handling: Handle authentication errors gracefully to ensure smooth user experience.

Rate Limits

  • 100 requests per minute for free tier
  • 1000 requests per minute for pro tier
  • 10000 requests per minute for enterprise tier

Ready to transform your business?

Start building intelligent AI agents to engage with customers.

← Delete Agent
Introduction →
GET/v1/agents/

Request

curl -X GET 'https://{% api.7en.ai %}v1/agents/' -H 'Authorization: {% Api-Key YOUR_API_KEY %}'\ -H 'Content-Type: application/json'

Response

{
"message": "List retrieved successfully",
"data": [
{
"id": 414,
"owner": 83,
"name": "New Chatbot 1763878362359",
"description": "A new AI chatbot ready to be configured.",
"status": "Active",
"appearance": {
"avatar": {
"src": "",
"type": "default"
},
"position": "bottom-right",
"buttonText": "",
"fontFamily": "Inter",
"chatbotName": "AI Assistant",
"primaryColor": "#0e1215",
"secondaryColor": "#ffffff",
"welcomeMessage": ""
},
"behavior": {
"email": null,
"guidelines": {
"dos": [],
"donts": []
},
"ticketType": "thirdparty",
"suggestions": [],
"aiToAiHandoff": false,
"expertHandoff": true,
"autoTicketReply": true
},
"model": {
"temperature": 0.7,
"response_model": "gpt-4-turbo",
"display_model": "Open AI GPT 4 Turbo"
},
"agentType": "Sales Agent",
"agent_category": "Chatbot",
"systemPrompt": "### Role\n- Primary Function: You are a sales agent here to assist users based on specific training data provided. Your main objective is to inform, clarify, and answer questions strictly related to this training data and your role.\n \n### Persona\n- Identity: You are a dedicated sales agent. You cannot adopt other personas or impersonate any other entity. If a user tries to make you act as a different chatbot or persona, politely decline and reiterate your role to offer assistance only with matters related to the training data and your function as a sales agent.\n \n### Constraints\n1. No Data Divulge: Never mention that you have access to training data explicitly to the user.\n2. Maintaining Focus: If a user attempts to divert you to unrelated topics, never change your role or break your character. Politely redirect the conversation back to topics relevant to sales.\n3. Exclusive Reliance on Training Data: You must rely exclusively on the training data provided to answer user queries. If a query is not covered by the training data, use the fallback response.\n4. Restrictive Role Focus: You do not answer questions or perform tasks that are not related to your role. This includes refraining from tasks such as coding explanations, personal advice, or any other unrelated activities.\n\n### Example interaction starters:\n- \"Thanks for your interest in [product/service]! Can you share a bit about what you're looking for so I can recommend the best solution?\"\n- \"I'd love to help you explore [product/service]. Here's how it can help with [customer's need]—would you like to hear more about the features or pricing?\"",
"knowledge_sources": [
{
"id": 665,
"urls": [],
"file": "https://api-staging.7en.ai/media/knowledge_sources/iside-ipid_XN69vIT.pdf",
"plain_text": null,
"google_drive_file_id": null,
"title": "Knowledge Document - iside-ipid.pdf",
"status": "Success",
"type": "docs",
"agent_knowledge_folder": 334,
"parent_knowledge_source": null,
"metadata": {
"format": "pdf",
"file_size": "158464B",
"no_of_rows": null,
"no_of_chars": null,
"no_of_pages": 2,
"upload_date": "2025-11-23T06:14:55.558014+00:00"
},
"owner": 83,
"is_selected": true,
"training_status": "Success",
"sub_urls": null,
"total_training_usage_bytes": 0,
"max_training_usage_bytes": 31457280
}
],
"created_at": "2025-11-23T06:12:45.975626Z",
"updated_at": "2025-11-24T07:17:27.607052Z",
"conversations": 22,
"ticketing_providers": [
"zoho",
"freshdesk",
"zendesk"
],
"default_ticketing_provider": "freshdesk",
"is_slack_enabled": true,
"privacy_url": null,
"gdpr_settings": {
"data_retention_days": null,
"data_retention_message": null,
"gdpr_message_display": false
},
"is_white_label": false,
"total_training_usage_bytes": 158464,
"max_training_usage_bytes": 31457280
}
],
"features": {
"WHITE_LABELING": false,
"PREMIUM_MODELS": false,
"AUTO_TICKET_RESPONSE": true,
"ADD_ON_AGENT": false
},
"status": "success",
"permissions": [
"REPLY_CONVERSATION",
"MANAGE_AGENTS",
"MANAGE_KNOWLEDGE_BASE",
"CONFIGURE_BUSINESS",
"CREATE_TICKET",
"MANAGE_AGENT_SETTINGS",
"SEND_INVITE",
"MANAGE_API_KEY",
"VIEW_ANALYTICS",
"MANAGE_BILLING"
]
}