Skip to navigation

Upload Term Image

Upload an image to attach to a term.

Send the file as multipart form data in the file field. PNG, JPEG, GIF, WebP and PDF are accepted, up to 10 MB; the type is detected from the file’s content, not its name or declared type.

To attach the image, write the returned filename as the value of an IMAGE_URL custom field on the term. Fetch it again with GET /images/{filename}.

Returns 413 if the file is larger than 10 MB, 415 for any other file type, and 422 for an empty file.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a multipart form containing a file.
filefileRequired

Response

Successful Response
filenamestring

Name of the stored image. Write it as the value of an IMAGE_URL custom field, and pass it to GET /images/{filename} to download the image.

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error