v50

latestOpenAPI 3.1.0Creative Force Client Subscription Termsraw.githubusercontent.com2026-07-137852387.4 KB

Upload a category file

Uploads a file for the category identified by the specified slug.

post/category/{category_slug}/upload

Headers

Accept'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml' required

Defines the response type.

Request body

filenamestring required

Original filename of the uploaded file, including the extension.

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

Example request

{
  "filename": "logo.png",
  "data": "aGVsbG8gd29ybGQ="
}

Response

Category file uploaded.

filenamestring

Original filename of the uploaded file, including the extension.

tokenstring

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

linkstring uri

Canonical URL for retrieving the uploaded file.

Example response

{
  "filename": "example.pdf",
  "token": "AbCdEfGhIjKlMnOp",
  "link": "https://api.au.cr4ce.com/file/AbCdEfGhIjKlMnOp"
}