For AI agents: a machine-readable documentation index for this API is available at /llms.txt. Every page is also available as Markdown: append ".md" to the URL or send an "Accept: text/markdown" request header.

Start uploading a brand file

Step 1 of 2. Send the slot the file is for: icon, main_logo, banner, social_image, favicon (each replaces the current one), logo (an extra logo), asset (a collection file), team_photo (one team member's photo, replaces the current one) or guideline_image (adds a picture to a guideline section). Optionally send size and filename to be refused early. The answer holds a signed upload address: PUT the file bytes to upload.url (it expires after expires_in seconds), then call completeBrandFileUpload with file_id. Nothing is attached yet. The limits are the brand editor's: logos and icons PNG, JPG, WebP or SVG up to 10 MB; banners and social images PNG, JPG or WebP up to 10 MB; favicons also ICO, up to 2 MB; collection files of any type up to 100 MB. A brand can have 20 extra logos; asset needs a brand without older-editor images (409 otherwise). Needs brands:files.

What you provide

  • Slot
  • Sizeoptional: The file's size in bytes; refused early when over the slot's limit
  • Filenameoptional: The file's name; refused early when its extension is not allowed for the slot

Do this with AI

I want to start uploading a brand file. Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/startbrandfileupload.md Authenticate with your API key as a Bearer token in the Authorization header. Then make the request for me and tell me what came back.

Paste this into Claude, Cursor, or any AI assistant and it will do it for you.