Link a Skill to an Agent

POST

/api/v2/agents/{agent_id}/skills/{skill_id}/enable

Link a skill to the agent.

Linking targets the agent's staging copy; publish the agent to roll the
change out to its live version. Re-linking a skill the agent already has
is a no-op.

Path Parameters:

agent_id (int): ID of the agent to link the skill to.

skill_id (int): ID of the skill to link.

Returns:

201 Created: the skill was linked.

200 OK: the skill was already linked (no-op).

400: the skill is unavailable for linking, or the agent has reached
its per-agent skill limit (the response details the limit,
current_count, and scope), or the skills feature is disabled.

403: caller lacks access to manage this agent.

404: the agent or skill could not be found.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢201

application/json

Bodyapplication/json

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request POST 'https:///api/v2/agents//skills//enable' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

201 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "id": 0,
        "agent_id": 0,
        "skill_id": 0,
        "skill_name": "string",
        "description": "",
        "created_by": "string"
    }
}

Unlink a Skill from an Agent

Get all Agents