Skip to main content
POST
Upload chapter file
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, application, or user field.

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}.

Canonical URL for retrieving the uploaded file.