Wexa AI
  1. Agentflows
Wexa AI
  • Wexa AI
  • Use Cases and Workflows
  • API Reference
  • Troubleshooting Guide
  • Onboarding
    • Getting Started with Wexa
    • Hire your AI Coworker
  • AI Coworker Creation
    • Create your First AI Coworker
    • Process Flows
    • Creating your First Agent
    • Schedule a Process Flow
    • Executing a Process Flow
    • Settings - Input Form
    • History
  • Tables
    • Intro to Tables
    • Adding records to Tables
    • Table Triggers
  • Knowledge Base
    • Intro to Knowledge Base
  • Connectors and MCP Servers
    • Adding a New Connector
    • Adding an MCP Server
    • Setting up Connectors Triggers
  • API Endpoints
    • Project
      • create project
      • Get all projects
      • Get project
      • update project
      • Delete project
    • Agentflows
      • create agentflow
        POST
      • get agentflows
        GET
      • Get agentflow by projectId and UserId
        GET
      • get agentflow by id
        GET
      • Add skilled agent to agentflow
        POST
      • Update skilled agent
        POST
    • Connectors
      • get connectors by projectid
      • get connector by Id
      • Delete a connector
      • connector update status
      • get all available trigger actions
    • Skills
      • create skill
      • get skills
      • get skills by category'
      • get skills by id
      • skills by name
    • Executeflow
      • create executeflow
      • get executions
      • execute agentflow
      • pause executeflow
      • resume execution
      • cancel executeflow
      • get execution by execution id
      • get execution details for monitoring
    • Customer
      • get customer
      • Get credit history
    • Actions
      • create action
      • get action
    • Files
      • Connectors and MCP Servers
      • upload files
      • get files by fileid
      • get connector by fileid
      • get files by connector_id
    • Inbox
      • get inbox
    • Tags
      • tags
    • Tasks
      • get tasks
      • get task by id
      • Pause running task
      • resume task
      • Stop task
    • Tables
      • create table
      • create database
      • get tables
      • get records list
      • get table names
      • delete record
      • delete a column
    • Dashboard
      • get dashboard
      • refresh dashboard
      • delete component in dashboard
    • Settings
      • get settings
    • Marketplace
      • get all connectors
      • get marketplace coworkers
      • get marketplace coworker by id
    • Coworker schedules
      • get schedules
      • create coworker schedule
      • get schedule coworker by its id
      • update schedule by its id
      • delete schedule by its id
    • Analytics
      • Get analytics
    • Marketplace coworkers
      • hire a coworker
      • check marketplace coworker update
    • Project member
      • project_member
    • Available Connectors
      • Actions
    • Execution Details
      • Execution details
  1. Agentflows

Add skilled agent to agentflow

POST
https://api.wexa.ai/agentflow/{agentflow_id}/skilled
Last modified:2025-04-25 08:52:54

Add Skilled Agent to AgentFlow#

Integrate a skilled AI agent into an existing AgentFlow by specifying the agentflow_id. This endpoint allows you to enhance the capabilities of your AgentFlow by adding agents equipped with specific skills, enabling more complex and dynamic automation workflows tailored to your organization's needs.

Request

Path Params

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Add skilled agent to agentflow
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.wexa.ai/agentflow//skilled?projectID=67fdea40aac77be632954f13' \
--header 'x-api-key: {{x-api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{"_id":"68075b23f6570e1e34cbece0","role":"content creator testing","title":"content creator testing","skills":["68063653fc2e1fb8597c775f"],"context":[],"llm":{"model":"azure/gpt-4o","max_tokens":10000,"temperature":0},"memory":{"memory_type":"lt"},"agent_type":"skilled_agent","role_description":"content creator testing","prompt":{"template":"create a content about abdul kalam","variables":[],"display_template":"[{\"type\":\"paragraph\",\"children\":[{\"text\":\"create a content about abdul kalam\"}]}]"},"triggers":[],"has_knowledge_base":false,"is_user_specific_task":false,"is_preview_mode_enabled":false,"conditions":[{"decision":"","condition":""}]}'
Response Response Example
{
    "_id": "68075a61ff5c4953f0170a10",
    "name": "content creator testing",
    "description": "content creator testing",
    "role": "content creator testing",
    "projectID": "67fdea40aac77be632954f13",
    "image": "https://klotdev.blob.core.windows.net/coworkers/process-flow-wexa-10.png",
    "agentflow_type": "master",
    "parent_agentflow_id": null,
    "failover_goal": null,
    "created_at": 1745312352.995075,
    "updated_at": 1745312663.00578,
    "last_used": 1745312352.995086,
    "isActive": true,
    "is_deleted": false,
    "default_goal": "",
    "is_cron_scheduled": false,
    "organization_id": "67fdea40aac77be632954f0f",
    "cron_details": {
        "agentflow_id": "",
        "goal": {
            "template": "",
            "display_template": ""
        },
        "collection_name": null,
        "query": {},
        "projectID": "",
        "frequency": "",
        "limit": null,
        "query_limit": null,
        "executed_by": null,
        "filters": null,
        "count": null
    },
    "anomaly_detection": {
        "is_enabled": false,
        "instructions": ""
    },
    "agents": [
        {
            "_id": "68075b23f6570e1e34cbece0",
            "title": "content creator testing",
            "role": "content creator testing",
            "role_description": "content creator testing",
            "llm": {
                "model": "azure/gpt-4o",
                "temperature": 0,
                "max_tokens": 10000
            },
            "context": [],
            "has_knowledge_base": false,
            "prompt": {
                "template": "create a content about abdul kalam",
                "variables": [],
                "display_template": "[{\"type\":\"paragraph\",\"children\":[{\"text\":\"create a content about abdul kalam\"}]}]"
            },
            "triggers": [],
            "is_user_specific_task": false,
            "pre_and_post_execution_input": null,
            "skills": [
                {
                    "_id": "68063653fc2e1fb8597c775f",
                    "name": "Content creator - Content creation",
                    "projectID": "67fdea40aac77be632954f13",
                    "connector_id": "68063653fc2e1fb8597c775e",
                    "description": "Creates content",
                    "logo": "https://klotdev.blob.core.windows.net/wexa/92d70903-e331-445f-a34d-eebc93d4a520_429-4292382_generalicons-meeting-social-security-icon-png.png",
                    "connector_name": "Content creator",
                    "is_deleted": false,
                    "user_id": "67fdea40aac77be632954f0e",
                    "actions": [
                        {
                            "_id": "68063654fc2e1fb8597c7760",
                            "name": "Content creation",
                            "endpoint": "/content_creator/generate",
                            "sort": "generate",
                            "category": "content_creator",
                            "previous_action_id": null,
                            "next_action_id": null,
                            "is_terminal": true,
                            "input_schema": {
                                "fields": [
                                    {
                                        "field_id": "content",
                                        "label": "content to generated",
                                        "type": "object",
                                        "required": true,
                                        "description": "A JSON object with the data that is to be saved in the execution context and should be generated by an LLM. You can follow the instructions given in the task to generate appropriate json data. This is mandatory and you should provide the data in the format mentioned in the task. If nothing is mentioned, just interpret any relevant data and provide it in the JSON format."
                                    }
                                ]
                            },
                            "output_schema": {
                                "fields": [
                                    {
                                        "field_id": "content",
                                        "label": "Generated content",
                                        "type": "object",
                                        "required": true,
                                        "description": "A JSON object representing the generated content based on the provided instructions."
                                    }
                                ]
                            },
                            "description": "This is a dummy connector that simply returns the input data as the output data.So when no other skills are available, this connector can be used."
                        }
                    ],
                    "initial_action_id": "68063654fc2e1fb8597c7760"
                }
            ],
            "agent_type": "skilled_agent",
            "next_agent": "68075b23f6570e1e34cbece0",
            "is_preview_mode_enabled": false
        },
        {
            "_id": "68075b23f6570e1e34cbece0",
            "title": "content creator testing",
            "role": "content creator testing",
            "role_description": "content creator testing",
            "llm": {
                "model": "azure/gpt-4o",
                "temperature": 0,
                "max_tokens": 10000
            },
            "context": [],
            "has_knowledge_base": false,
            "prompt": {
                "template": "create a content about abdul kalam",
                "variables": [],
                "display_template": "[{\"type\":\"paragraph\",\"children\":[{\"text\":\"create a content about abdul kalam\"}]}]"
            },
            "triggers": [],
            "is_user_specific_task": false,
            "pre_and_post_execution_input": null,
            "skills": [
                {
                    "_id": "68063653fc2e1fb8597c775f",
                    "name": "Content creator - Content creation",
                    "projectID": "67fdea40aac77be632954f13",
                    "connector_id": "68063653fc2e1fb8597c775e",
                    "description": "Creates content",
                    "logo": "https://klotdev.blob.core.windows.net/wexa/92d70903-e331-445f-a34d-eebc93d4a520_429-4292382_generalicons-meeting-social-security-icon-png.png",
                    "connector_name": "Content creator",
                    "is_deleted": false,
                    "user_id": "67fdea40aac77be632954f0e",
                    "actions": [
                        {
                            "_id": "68063654fc2e1fb8597c7760",
                            "name": "Content creation",
                            "endpoint": "/content_creator/generate",
                            "sort": "generate",
                            "category": "content_creator",
                            "previous_action_id": null,
                            "next_action_id": null,
                            "is_terminal": true,
                            "input_schema": {
                                "fields": [
                                    {
                                        "field_id": "content",
                                        "label": "content to generated",
                                        "type": "object",
                                        "required": true,
                                        "description": "A JSON object with the data that is to be saved in the execution context and should be generated by an LLM. You can follow the instructions given in the task to generate appropriate json data. This is mandatory and you should provide the data in the format mentioned in the task. If nothing is mentioned, just interpret any relevant data and provide it in the JSON format."
                                    }
                                ]
                            },
                            "output_schema": {
                                "fields": [
                                    {
                                        "field_id": "content",
                                        "label": "Generated content",
                                        "type": "object",
                                        "required": true,
                                        "description": "A JSON object representing the generated content based on the provided instructions."
                                    }
                                ]
                            },
                            "description": "This is a dummy connector that simply returns the input data as the output data.So when no other skills are available, this connector can be used."
                        }
                    ],
                    "initial_action_id": "68063654fc2e1fb8597c7760"
                }
            ],
            "agent_type": "skilled_agent",
            "next_agent": null,
            "is_preview_mode_enabled": false
        }
    ],
    "initialAgent": "68075b23f6570e1e34cbece0"
}
Modified at 2025-04-25 08:52:54
Previous
get agentflow by id
Next
Update skilled agent