Save images (upload)

Upload one or more image files to S3 (under account/images/{type}) and creates an Image row per file for the company, returning the saved records with public S3 URLs. Sent as multipart/form-data.

Auth: Both — authentication. Target company must sit inside your own account tree, keyed on company_id: it must resolve into the authenticated user's company hierarchy. A Partner can target any company in its tree; an Account reaches only its own hierarchy.

Rate limit: No rate limit.

Request

  • Body (multipart/form-data):
FieldTypeRequiredNotes
company_idintegerYesMust be an existing account and belong to the auth company hierarchy.
typestringYesOne of partners, campaign.
imagesarray (file[])YesOne or more uploaded files.
images.*fileYesEach must be an image, mimes jpeg/png, max 2048 KB.
statusstringNoPersisted as-is; controller defaults to active when you omit it (not validated).

Response{ data. } envelope.

  • status (string) — success.
  • message (string) — Logos saved successfully!.
  • data (array) — one object per saved image:
  • id (integer) — new image id.
  • name (string) — sanitized original filename ([^\w.\-] replaced with _, truncated to 100 chars) plus guessed extension.
  • type (string) — echoes request type.
  • status (string) — request status or active.
  • path (string) — full S3 URL of the stored file.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
string
file
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json