Unlink a Skill from an Agent

DELETE

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

Unlink a skill from the agent.

Unlinking targets the agent's staging copy; publish the agent to roll
the change out to its live version. Unlinking a skill the agent is not
linked to is a no-op.

Path Parameters:

agent_id (int): ID of the agent.

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

Returns:

200 OK: the skill was unlinked, or no link existed (no-op).

400: the skills feature is disabled, or the skill is a platform
default (platform defaults are removed via the organization-level
disable, not per-agent unlink).

403: caller lacks access to manage this agent.

404: the agent could not be found.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

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

Get all Skills available to an Agent

Link a Skill to an Agent