Skip to main content
POST
Use this operation to upload a chapter image.
The uploaded file is validated and stored before the response is returned; the image itself is processed shortly after. A GET on the returned Location immediately after the 201 may briefly return a response with a null body until processing is complete.

Authorizations

​
x-api-key
string
header
required

API key used to authenticate and authorise every request. Include it in the x-api-key header.

Headers

​
Accept
enum<string>
required

Defines the response type.

Available options:
application/vnd.Creative Force.v2.3+json,
application/vnd.Creative Force.v2.3+xml

Path Parameters

​
chapter_slug
string
required

Slug of the chapter.

Pattern: ^[A-Za-z]{8}$

Body

application/json

Image payload for the chapter upload.

filename and data are required.

​
filename
string
required

Original filename of the uploaded file, including the extension.

​
data
string<byte>
required

Base64-encoded contents of the image file.

The encoded payload must round-trip cleanly through standard base64 decoding; payloads with stray characters, incorrect padding, or other malformed encoding are rejected.

Only image files are accepted: gif, jpeg, jpg, png, tif, tiff, ico, webp, and avif. The file size must not exceed the maximum file size for the account.

Response

Chapter file uploaded.

Receipt returned when a file is uploaded to a category, chapter, entry, or user field.

Carries the original filename, a short opaque token that addresses the stored file, and the canonical URL through which the file can be retrieved.

​
filename
string

Original filename of the uploaded file, including the extension.

​
token
string

Opaque identifier for the stored file. Used as the {token} path parameter on /file/{token}.

​
link
string<uri>

Canonical URL for retrieving the uploaded file.