PUT playable/…/publish
Publishes a playable to a catalog.
A catalog is only accessible to those accounts who have been granted access. Currently only drills and courses may be published.
Resource URL
https://www.drillster.com/api/2.1.1/playable/{playable_id}/publish
Parameters
Field | Type | Description |
---|---|---|
playable required |
String | The ID of the playable that is to be published. Please note: at this time only drillables can be published. |
catalog required |
String | The ID of the catalog to be published to. The calling user must have access to the catalog. |
position optional |
Number | The position of the playable in the catalog. Must be between 0 and the current size of the catalog (inclusive). If not provided, it will be added at the end. |
Response
A NoContent (204) response indicating that the playable has been published.
Error responses
The following error situations are possible:
ID | Response code | Description |
---|---|---|
catalog_not_found |
400 (Bad request) | The given catalog could not be found. |
invalid_position |
400 (Bad request) | The provided position is invalid. |
playable_part_of_catalog |
400 (Bad request) | The playable is already part of the catalog. |
not_permitted |
403 (Forbidden) | Caller is not permitted to publish the drill to the given catalog. |
not_released |
400 (Bad request) | Given drill has not been released yet. |
unknown_drillable |
404 (Not found) | Given playable is not known. |