Get all Skills available to an Agent

GET

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

List the skills available to this agent, each flagged with whether the
agent is currently linked to it.

Supports searching, filtering, sorting, verbosity control, and optional
pagination via the query parameters documented below. Pass
agent_version=staging to list skills for the agent's staging copy
instead of its published version.

Path Parameters:

agent_id (int): ID of the agent.

Returns:

200 OK: the available skills, each carrying an is_connected flag.

400: a query parameter is invalid, or the skills feature is disabled.

403: caller lacks access to view this agent.

404: the agent does not exist, or is not associated with an organization.

Current Version:

2.0.0

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https:///api/v2/agents//skills?category=undefined&is_connected=undefined&is_default=undefined&is_enabled=undefined&items_per_page=undefined&page=undefined&paginated=undefined&query=undefined&sort_by=undefined&verbosity=undefined' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "items": [
            {
                "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",
                "is_connected": true,
                "owner_org_id": 0,
                "owner_id": 0,
                "category_id": 0,
                "connection": {
                    "id": 0,
                    "connected_by": "string",
                    "connected_on": "2019-08-24T14:15:22.123Z"
                }
            }
        ],
        "meta": {
            "count": 0,
            "num_pages": 0,
            "current_page": 0
        }
    }
}

Get user permissions on multiple agents

Unlink a Skill from an Agent