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

Update skilled agent

POST
https://api.wexa.ai/agentflow/{agentflow_id}/update/skilled/{agent_id}
Last modified:2025-04-25 08:56:45

Update Skilled Agent in AgentFlow#

Update the configuration of an existing skilled AI agent within a specified AgentFlow by providing the unique agentflow_id and agent_id. This endpoint allows you to modify the agent's parameters, such as its role, skills, enabling the refinement and optimization of your automation workflows to better align with evolving business requirements.

Request

Path Params

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Update skilled agent
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.wexa.ai/agentflow//update/skilled/?projectID=67fdea40aac77be632954f13' \
--header 'x-api-key: {{x-api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role": "content creator testing",
    "title": "content creator testing",
    "skills": [
        "68063653fc2e1fb8597c775f"
    ],
    "prompt": {
        "display_template": "[{\"type\":\"paragraph\",\"children\":[{\"text\":\"create a content about ai replacing humans in future\"}]}]",
        "variables": [],
        "template": "create a content about ai"
    },
    "context": [],
    "triggers": [],
    "llm": {
        "model": "azure/gpt-4o",
        "max_tokens": 10000,
        "temperature": 0
    },
    "role_description": "content creator testing",
    "memory": {
        "memory_type": "lt"
    },
    "has_knowledge_base": false,
    "is_user_specific_task": false,
    "is_preview_mode_enabled": false
}'
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": 1745313020.668533,
    "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 ai",
                "variables": [],
                "display_template": "[{\"type\":\"paragraph\",\"children\":[{\"text\":\"create a content about ai replacing humans in future\"}]}]"
            },
            "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:56:45
Previous
Add skilled agent to agentflow
Next
get connectors by projectid