API ReferenceMemegen

Create Template

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
namestringRequired
imageUrlstringRequired
slugstringOptional
Left out, one is derived from the name and numbered if it clashes. Given and already taken, the request is refused rather than renamed.
layoutenumOptional
Where the captions sit on a template.
widthintegerOptional
heightintegerOptional
attributionstringOptional
sourceUrlstringOptional
sortOrderintegerOptional

Response

This endpoint returns an object.
idstring
organizationIdstring
namestring
slugstring
layoutenum
Where the captions sit on a template.
curatedboolean
Part of the library the workspace curates, rather than a background somebody found while composing one meme. Only curated templates appear in the picker.
archivedboolean
Out of the picker. Memes already made from it keep rendering, which is why a template is archived rather than deleted.
sortOrderinteger
createdAtdatetime
updatedAtdatetime
builtinKeystringOptional
Set on the templates that ship with the app.
imageUrlstringOptional
widthintegerOptional
The background's real pixel size, so the canvas can match the picture instead of cropping it into a fixed box.
heightintegerOptional
attributionstringOptional
Where a searched template came from. The background is served from there rather than copied, so the credit stays with the row.
sourceUrlstringOptional

Errors

402
Subscription Required Error
409
Conflict Error
422
Validation Error