?
Support
Vielen Dank für Ihren Besuch. Diese Seite ist momentan nur auf Englisch verfügbar. Wir arbeiten an der deutschen Version. Vielen Dank für Ihr Verständnis.

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