Create Entry

Add content to a feed. Supports multiple content types up to 50MB.

POST/v1/feeds/{feed_id}/entries

Overview

Create a new entry with base64-encoded content. Supports text, JSON, HTML, images, video, audio, and documents. Content can be free or paid.

Authentication: Required
Payment: x402 micropayment required

Request

Path Parameters

Parameter	Type	Required
`feed_id`	string (UUID)	Yes

Body Parameters

Parameter	Type	Required	Description
`content_base64`	string	Yes	Base64-encoded content (max 50MB)
`mime_type`	string	Yes	Content MIME type
`title`	string	No	Entry title
`description`	string	No	Entry description
`tags`	string[]	No	Array of tags (max 20)
`is_free`	boolean	No	Free content (default: true)
`price`	object	No	Pricing for paid content

Request Body

{
  "content_base64": "SGVsbG8sIFdvcmxkIQ==",
  "mime_type": "text/plain",
  "title": "Welcome Post",
  "description": "Welcome to my feed",
  "tags": ["welcome"],
  "is_free": true
}

Response

{
  "id": "entry-uuid",
  "feed_id": "feed-uuid",
  "cid": "bafkreigxyz...",
  "mime_type": "text/plain",
  "title": "Welcome Post",
  "tags": ["welcome"],
  "is_free": true,
  "is_active": true,
  "total_purchases": 0,
  "total_revenue": "0",
  "created_at": 1734192000
}

Code Examples

cURL

curl -X POST https://api.grapevine.fyi/v1/feeds/{feed_id}/entries \
  -H "Content-Type: application/json" \
  -H "x-wallet-address: 0x..." \
  -H "x-signature: 0x..." \
  -H "x-message: ..." \
  -H "x-timestamp: 1234567890" \
  -H "x-chain-id: 8453" \
  -H "X-PAYMENT: ..." \
  -d '{
    "content_base64": "SGVsbG8sIFdvcmxkIQ==",
    "mime_type": "text/plain",
    "title": "Welcome Post",
    "is_free": true
  }'

Supported MIME Types

Text: text/plain • text/markdown • text/html
Data: application/json
Images: image/png • image/jpeg • image/gif • image/webp • image/svg+xml
Video: video/mp4 • video/quicktime • video/webm
Audio: audio/mpeg • audio/wav • audio/ogg
Documents: application/pdf

Notes

Content Limit: 50MB maximum (base64 encoded)
Private IPFS Storage: Content stored on Private IPFS, returns cid
Entry Limit: 1000 entries per feed
Payment: Entry creation requires x402 micropayment