Create Meme

POST

/memes

POST

/api/v1/memes

curl -X POST https://api.taktoria.com/api/v1/memes \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "templateId": "templateId",
  "captions": [
    "captions",
    "captions"
  ]
}'

{
  "id": "id",
  "organizationId": "organizationId",
  "templateId": "templateId",
  "captions": [
    "captions",
    "captions"
  ],
  "score": 1,
  "hasVoted": true,
  "createdAt": "2024-01-15T09:30:00Z",
  "template": {
    "id": "id",
    "organizationId": "organizationId",
    "name": "name",
    "slug": "slug",
    "layout": "CAPTION",
    "curated": true,
    "archived": true,
    "sortOrder": 1,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "builtinKey": "builtinKey",
    "imageUrl": "imageUrl",
    "width": 1,
    "height": 1,
    "attribution": "attribution",
    "sourceUrl": "sourceUrl"
  },
  "layout": "CAPTION",
  "author": {
    "id": "id",
    "name": "name",
    "email": "email",
    "image": "image"
  },
  "authorId": "authorId"
}

Made by the app’s rules, whoever asks: the template must be in the workspace and not archived, the captions are folded, cut at 140 characters and fitted to the layout’s boxes (padded or trimmed), a meme with no words is refused with 422, a layout equal to the template’s is not stored, and the meme appears in the workspace’s activity. A signed-in session makes it as that person; a key’s is credited, in the feed and in the activity, to the key’s maker.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

templateIdstringRequired

A template in the workspace that is still in the picker. One an app admin archived is refused with 422; memes already made from it are kept and keep rendering. A one-off background (curated: false) may be used.

captionslist of stringsRequired

One per caption box, in the layout’s order. Each is folded onto one line and cut at 140 characters; extra captions are dropped and missing ones left empty. At least one must have words, or 422. Up to 8, each at most 500 characters as sent.

layoutenumOptional

A different layout for this meme only. Stored only when it differs from the template's own.

Allowed values:

Response

This endpoint returns an object.

idstring

organizationIdstring

templateIdstring

captionslist of strings

One per caption box, in order.

scoreinteger

Upvotes. There is no downvote: a workplace tool that lets colleagues bury each other’s jokes is a different, worse product.

hasVotedboolean

Whether the signed-in person has upvoted it. Always false for an API key, which acts for the workspace and has no vote.

createdAtdatetime

templateobjectOptional

A background somebody can caption.

layoutenumOptional

What this meme wanted, when that differs from its template’s own layout. Absent means “whatever the template says”, so re-pointing a template still moves every meme that never overrode it.

Allowed values:

authorobjectOptional

A person in a Taktoria organization.

authorIdstringOptional

Errors

402

Subscription Required Error

403

Forbidden Error

404

Not Found Error

422

Validation Error

429

Too Many Requests Error