Disable a Skill for all Agents in an Organization

DELETE

/api/v2/organizations/{organization_id}/skills/{skill_id}/disable

Disable a skill for the organization and unlink it from its agents.

Requires organization admin rights.

Path Parameters:

organization_id (int): ID of the organization.

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

Returns:

200 OK: the skill as it now appears in the organization, or an empty
payload when there was nothing to disable (no-op).

400: the skills feature is disabled.

403: caller lacks access to manage this organization.

404: the organization could not be found.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "id": 0,
        "name": "string",
        "description": "string",
        "category": "string",
        "type": "string",
        "org_id": 0,
        "is_enabled": true,
        "is_draft": true,
        "is_default": true,
        "created_by": "string",
        "created_on": "2019-08-24T14:15:22.123Z",
        "modified_by": "string",
        "modified_on": "2019-08-24T14:15:22.123Z",
        "owner_org_id": 0,
        "owner_id": 0,
        "category_id": 0,
        "connected_agent_count": 0
    }
}

Retrieve a Skill in an Organization

Enable a Skill for all Agents in an Organization