assets

Create an asset

Registers an image or video by public URL. The asset is stored as a pointer to that URL and is READY immediately; the bytes are fetched when a sync needs them. Attach it to a campaign, ad group or ad with the binding operations under Campaign assets and Ad assets.

Errors

  • 400 VALIDATION_ERROR: the body failed validation; details.issues[] names each field.
post/api/v1/assets

Request

  • Base URL: https://api.growomat.com
  • URL: https://api.growomat.com/api/v1/assets
  • Auth: HTTP bearer

Headers

X-Space-Idstring

The Space to work in, for example spc_8f3aK2. Omit it to use your personal Space. List your Spaces returns the ids. A Space that does not exist returns 404 SPACE_NOT_FOUND; one you are not a member of returns 403 NOT_A_MEMBER.

Request body

urlstring uri required

A public http(s) URL of the image or video.

namestring

Display name. Defaults to the file name in the URL.

type'IMAGE' | 'LOGO' | 'VIDEO'

What the asset is used as.

mediaType'IMAGE' | 'VIDEO'

The media kind. Derived from type when omitted (IMAGE for IMAGE and LOGO, VIDEO for VIDEO).

youtubeVideoIdstring

For video assets: the YouTube video id. Videos are referenced, never hosted or transcoded by Growomat.

contentTypestring

MIME type. Inferred from the URL when omitted.

sizeBytesinteger

File size in bytes, when known.

widthinteger

Width in pixels, when known.

heightinteger

Height in pixels, when known.

tagsstring[]

Free-form tags for finding the asset later.

altTextstring

Alternative text describing the image.

metadataobject

Anything else you want to keep with the asset.

Response

OK. The result is in data. List responses also carry meta with nextCursor and total.

dataunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.