IBM API Hub
IBM watsonx Orchestrate API

By IBM watsonx Orchestrate

IBM watsonx Orchestrate provides a set of APIs to boost your experience using the features from the product.


API reference

Get a list of skill sets

GET

/skillsets

Applies to:

Get a list of the skill sets available in your tenant.

Note: Users must have Admin role to make requests to this operation.

Request URL
https://api.{hostname}/instances/{tenant_id}/v1/skillsets
https://{root_uri}/orchestrate/{namespace}/instances/{instanceid}/v1/skillsets
Security
http
bearer

Authentication schema for IBM watsonx Orchestrate on AWS.

JWT
apiKey
ZenApiKey
required in header

Authentication for IBM watsonx Orchestrate on On-premises.

apiKey
IAM-API_KEY
required in header

Authentication for IBM watsonx Orchestrate on IBM Cloud.

Responses
  • 200

    Successfully retrieved the skill sets.

  • 404

    Skill sets were not found.

  • 500

    Unexpected server error

Code snippet
    1curl --request GET \
    2  --url https://api.replace_hostname_variable/instances/REPLACE_TENANT_ID_VARIABLE/v1/skillsets \
    3  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
    4  --header 'IAM-API_KEY: REPLACE_THIS_VALUE' \
    5  --header 'ZenApiKey: REPLACE_THIS_VALUE' \
    6  --header 'accept: application/json'

      Example response

        1{
        2  "skillsets": [
        3    {
        4      "assistant_id": "00000000-0000-0000-0000-000000000000",
        5      "description": "",
        6      "name": "My skill set",
        7      "skillset_id": "00000000-0000-0000-0000-000000000000",
        8      "url": "https://api.example.watson-orchestrate.ibm.com/instances/00000000-0000-0000-0000-000000000000/v1/skillsets/00000000-0000-0000-0000-000000000000",
        9      "type": "ASSISTANT"
        10    }
        11  ]
        12}