?
サポート
アクセスいただきありがとうございます。こちらのページは現在英語のみのご用意となっております。順次日本語化を進めてまいりますので、ご理解のほどよろしくお願いいたします。

Skill Enablement (Skill Management API)

This API is used to enable skills programmatically, rather than from the developer portal. The developer can interact with the enablement as with other sub-resources.

Enable a skill

Enables a skill stage for the requestor. The requestor should be either a developer or the owner of the skill. Please note that only one skill stage can be enabled for a given user at one time. If another stage of a skill is already enabled for the requestor, this API will return HTTP/1.1 403 Forbidden response.

Request

PUT /v1/skills/{skillId}/stages/{stageName}/enablement

Parameters

FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. Accepted value is development (case sensitive).PathYes

Response

HTTP/1.1 204 No Content

Exceptions

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden 
HTTP/1.1 404 Not Found
HTTP/1.1 409 Conflict 
HTTP/1.1 500 Internal Service Error 
HTTP/1.1 503 Service Unavailable

Check enablement status of a skill

Checks whether a skill stage is enabled or not for the requestor. It returns 204 if the skill stage is enabled, and 404 otherwise.

Request

GET /v1/skills/{skillId}/stages/{stageName}/enablement 
FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. Accepted value is development (case sensitive).PathYes

Response

HTTP/1.1 204 No Content

Exceptions

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 429 Too Many Requests
HTTP/1.1 500 Internal Service Error
HTTP/1.1 503 Service Unavailable

Disable a skill

Disables a skill by deleting the skill enablement. If no skill enablement exists, then the skill must be enabled through the developer portal, unless another skill enablement is created.

Request

DELETE /v1/skills/{skillId}/stages/{stageName}/enablement
FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. Accepted value is development (case sensitive).PathYes

Response

HTTP/1.1 204 No Content

Exceptions

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 429 Too Many Requests
HTTP/1.1 500 Internal Service Error
HTTP/1.1 503 Service Unavailable