PUT content/{contentId} is a dual-purpose API method. This page is for updating existing content; for content creation, see this page.
If PUT is called with a contentId that already exists, we assume the user intended to update the description of the content item. The request body for this case is different from the creation case.
Only description, screenshots, and tags are available to be updated in this way.
PUT /api/v1/content/fc20ab3a-5dfe-40ac-b75a-b1d087083e15 HTTP/1.1
Authorization: Bearer ...
Content-Type: application/json
{
"description": "This is some new content.",
"screenshotUris": [
"protected/us-west-2:12345678-0000-0000-0000-123456789abc/03d1ac5e-b426-4612-8781-dc07900fd381.jpg"
],
"tags": [
"difficult",
"platformer",
"horror"
]
}
----------------------------------------
HTTP/1.1 204 No ContentAuthentication is required, and access is restricted to admins and the author of the content.
| Name | Description | Value |
|---|---|---|
| contentId | the ID of the content as a GUID with dashes | string |
| Name | Description | Value |
|---|---|---|
| description | the description of the content | string |
| screenshotUris | an array of screenshots, as paths relative to the media S3 bucket; the first screenshot is assumed to be the primary image | array of string |
| tags | the tags to associate with this content optional | array of string |
Successful responses are code 204. Error responses are standard.
NONE