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
| Field | Description | Parameter Type | Required |
|---|---|---|---|
skillId | Unique identifier of skill. | Path | Yes |
stage | Indicates stage of the skill. Accepted value is DEVELOPMENT. | Path | Yes |
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
| Field | Description | Parameter Type | Required |
|---|---|---|---|
skillId | Unique identifier of skill. | Path | Yes |
stage | Indicates stage of the skill. Accepted value is DEVELOPMENT. | Path | Yes |
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
| Field | Description | Parameter Type | Required |
|---|---|---|---|
skillId | Unique identifier of skill. | Path | Yes |
stage | Indicates stage of the skill. Accepted value is DEVELOPMENT. | Path | Yes |
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