Wexa AI
  1. Agentflows
Wexa AI
  • Wexa AI
  • Getting Started with Wexa AI
  • Use Cases and Workflows
  • API Reference
  • Tutorials
  • Troubleshooting Guide
  • 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
      • 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
  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 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"
}

Request

Path Params
agentflow_id
string 
required
Query Params
projectID
string 
required
Example:
67fdea40aac77be632954f13
Header Params
x-api-key
string 
required
Example:
{{x-api-key}}
Body Params application/json
_id
string 
required
role
string 
required
title
string 
required
skills
array[string]
required
context
array
required
llm
object 
required
model
string 
required
max_tokens
integer 
required
temperature
integer 
required
memory
object 
required
memory_type
string 
required
agent_type
string 
required
role_description
string 
required
prompt
object 
required
template
string 
required
variables
array
required
display_template
string 
required
triggers
array
required
has_knowledge_base
boolean 
required
is_user_specific_task
boolean 
required
is_preview_mode_enabled
boolean 
required
conditions
array [object {2}] 
required
decision
string 
optional
condition
string 
optional
Examples

Responses

🟢200Add skilled agent to agentflow
application/json
Body
_id
string 
required
name
string 
required
description
string 
required
role
string 
required
projectID
string 
required
image
string 
required
agentflow_type
string 
required
parent_agentflow_id
null 
required
failover_goal
null 
required
created_at
number 
required
updated_at
number 
required
last_used
number 
required
isActive
boolean 
required
is_deleted
boolean 
required
default_goal
string 
required
is_cron_scheduled
boolean 
required
organization_id
string 
required
cron_details
object 
required
agentflow_id
string 
required
goal
object 
required
collection_name
null 
required
query
object 
required
projectID
string 
required
frequency
string 
required
limit
null 
required
query_limit
null 
required
executed_by
null 
required
filters
null 
required
count
null 
required
anomaly_detection
object 
required
is_enabled
boolean 
required
instructions
string 
required
agents
array [object {15}] 
required
_id
string 
required
title
string 
required
role
string 
required
role_description
string 
required
llm
object 
required
context
array
required
has_knowledge_base
boolean 
required
prompt
object 
required
triggers
array
required
is_user_specific_task
boolean 
required
pre_and_post_execution_input
null 
required
skills
array [object {11}] 
required
agent_type
string 
required
next_agent
string  | null 
required
is_preview_mode_enabled
boolean 
required
initialAgent
string 
required
Modified at 2025-04-25 08:52:54
Previous
get agentflow by id
Next
Update skilled agent