Saved Media

Create meme from URL

Saves a new meme to favorites from a provided URL.

post/users/@me/memes

Request body

alt_textstring nullable

Alternative text description for accessibility

tagsstring[] nullable

Tags for categorizing and searching the meme

urlstring uri required

URL of the image or video to save as a favorite meme

gif_slugstring nullable

Provider-issued slug or slug-id token for the GIF, when sourced from a provider

gif_providerstring nullable

Stable name of the GIF provider that issued gif_slug. New provider GIFs are sourced from KLIPY.

mediaobject nullable

Optional provider-issued format-name → media descriptor map captured by the client at favorite-time (mirrors GifResponse.media). Only persisted for gif-sourced memes; ignored otherwise.

namestring nullable

Display name for the meme

Response

Success

idstring required

Unique identifier for the favorite meme

user_idstring required

ID of the user who owns this favorite meme

namestring required

Display name of the meme

alt_textstring nullable

Alternative text description for accessibility

tagsstring[] required

Tags for categorizing and searching the meme

attachment_idstring required

ID of the attachment storing the meme

filenamestring required

Original filename of the meme

content_typestring required

MIME type of the meme file

content_hashstring nullable

Hash of the file content for deduplication

sizeinteger required

File size in bytes

widthinteger nullable

Width of the image or video in pixels

heightinteger nullable

Height of the image or video in pixels

durationnumber nullable

Duration of the video in seconds

urlstring required

CDN URL to access the meme

is_gifvboolean

Whether the meme is a video converted from GIF

gif_slugstring nullable

Provider-issued slug for the GIF this meme was sourced from, if any

gif_providerstring nullable

Stable name of the GIF provider that issued gif_slug, if any. Legacy records may contain older provider names.

mediaobject nullable

Provider-issued format-name → media descriptor map for gif-sourced memes (mirrors GifResponse.media). Null on memes uploaded as plain attachments.

placeholderstring nullable

Compact thumbhash placeholder produced by the media proxy at favorite-time. Clients render it as a low-res preview while the full media loads. Null when the proxy did not emit one.

Changes

No recorded changes to this endpoint across all 1 revision of this API.