Upload a category file

Changed on Jul 7, 2026

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

post/category/{category_slug}/upload

Request

Base URL
https://api.us.cr4ce.com
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/tectonic/apis/award-force-api/docs/category/:category_slug/upload/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Changes

Jul 7, 2026v29b9103538ceb Revision changes
- info
  api tag Categories added
- info
  api tag Category removed
Jul 1, 2026v2e96a96d4507e Revision changes
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status
- info
  added the media type application/xml for the response with the status

Operation history