Posts
Create social media-style posts by uploading media directly to feeds.
Feed posts combine media uploads with social metadata to create rich content for structured feeds. This process creates the post record and provides presigned upload URLs for your media.
Feed posts require an existing feed. Learn about creating feeds if you haven't set one up yet.
Post Types
Video Posts – Upload videos with automatic poster generation and thumbnail images for feed display.
Image Posts – Upload standalone images optimized for mobile and web feeds with automatic AVIF conversion.
Upload Process
Posts combine media upload with feed publishing in a direct workflow:
Create Post Upload
Call the POST /posts/v1/projects/{project_id}/feeds/{feed_id}/posts/upload endpoint with your post metadata and media type.
Set Metadata Parameters
Specify content_type (CONTENT_TYPE_VIDEO or CONTENT_TYPE_IMAGE), creator_id, description, file_name, and optional quality settings.
Upload Media to Presigned URL
Use the returned content_upload_url (and optional poster_upload_url) to upload your media file directly via HTTP PUT.
Automatic Processing
Once uploaded to the storage URL, RIXL automatically processes the media and makes the post available in your feed.
Request Parameters
content_type–CONTENT_TYPE_VIDEOorCONTENT_TYPE_IMAGEfile_name– Name of your media file (e.g.highlight-clip.mp4)creator_id– Unique identifier for the user or author creating the postdescription– Caption or text for the postvideo_quality(optional, for videos) –VIDEO_QUALITY_BASIC,VIDEO_QUALITY_SHORTS, orVIDEO_QUALITY_PROimage_format(optional) – Poster image format (jpg,png,webp)
API Examples
1. Initialize Post Upload
curl -X POST "https://api.rixl.com/posts/v1/projects/{project_id}/feeds/{feed_id}/posts/upload" \
-H "X-API-Key: YOUR_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content_type": "CONTENT_TYPE_VIDEO",
"file_name": "highlight-clip.mp4",
"creator_id": "user_12345",
"description": "Check out this amazing view!",
"video_quality": "VIDEO_QUALITY_SHORTS"
}'Response:
{
"post_id": "PS5IMKoFLm",
"content_id": "VI9VXQxWXQ",
"poster_id": "IM8y3QB38S",
"content_upload_url": "https://videos.rixl.com/upload/...",
"poster_upload_url": "https://images.rixl.com/upload/...",
"upload_expires": "2026-01-15T12:00:00Z"
}2. Upload Media Directly
Use the returned presigned URLs to upload your files directly to cloud storage:
curl -X PUT "{content_upload_url}" \
--upload-file "/path/to/highlight-clip.mp4" \
-H "Content-Type: video/mp4"Managing Your Posts
Retrieve and manage feed posts via REST API:
Retrieving Posts
Get a Specific Post: Fetch metadata and media URLs for an individual post.
curl -X GET "https://api.rixl.com/posts/v1/projects/{project_id}/feeds/{feed_id}/posts/{post_id}" \
-H "X-API-Key: YOUR_PROJECT_API_KEY"List Posts in a Feed: Paginate through posts in a feed.
curl -X GET "https://api.rixl.com/posts/v1/projects/{project_id}/feeds/{feed_id}/posts?limit=25" \
-H "X-API-Key: YOUR_PROJECT_API_KEY"List Posts by Creator: Filter feed posts created by a specific user.
curl -X GET "https://api.rixl.com/posts/v1/projects/{project_id}/feeds/{feed_id}/posts/creators/{creator_id}?limit=25" \
-H "X-API-Key: YOUR_PROJECT_API_KEY"Deleting a Post
curl -X DELETE "https://api.rixl.com/posts/v1/projects/{project_id}/feeds/{feed_id}/posts/{post_id}" \
-H "X-API-Key: YOUR_PROJECT_API_KEY"Best Practices
- Provide descriptive metadata: Set clear captions and creator IDs to power client feed rendering and user attribution.
- Match quality tiers to use case: Use
VIDEO_QUALITY_SHORTSfor vertical mobile feeds, orVIDEO_QUALITY_PROfor high-resolution landscape showcases. - Leverage the React Feed component: Render feeds effortlessly in web apps with
<Feed feedId="..." />from@rixl/media-react.