Skip to content

entry add

Add new content entry to an existing feed.

Usage

grapevine entry add <feed-id> <content> [options]

Arguments

feed-id

  • Type: string (UUID)
  • Required: Yes

The unique identifier of the feed to add the entry to.

grapevine entry add "123e4567-e89b-12d3-a456-426614174000" "My content"

content

  • Type: string
  • Required: Yes

Main content of the entry. Can be text content or a file path when using --file.

grapevine entry add "123e4567..." "# Heading\n\nThis is **bold** text."

Options

-t, --title

  • Type: string

Title for the entry.

grapevine entry add "123e4567..." "My content" --title "Getting Started"

-m, --mime

  • Type: string

MIME type of the content (auto-detected if not provided).

grapevine entry add "123e4567..." "Content" --mime "text/markdown"

-f, --file

  • Type: boolean

Treat content argument as a file path.

grapevine entry add "123e4567..." "./article.md" --file

-p, --paid

  • Type: boolean

Make this entry paid (requires payment to access).

grapevine entry add "123e4567..." "Premium Content" --paid

--price

  • Type: string
  • Default: 1000000 (1 USDC)

Price in USDC smallest units (when using --paid).

grapevine entry add "123e4567..." "Premium Content" --paid --price 2000000

--tags

  • Type: string

Comma-separated tags for the entry.

grapevine entry add "123e4567..." "Content" --tags typescript,tutorial,beginner

Examples

Basic Free Entry

grapevine entry add "123e4567..." "Hello, world! This is my first entry." \
  --title "My First Post"

Entry from File

grapevine entry add "123e4567..." "./typescript-guide.md" \
  --file \
  --title "TypeScript Guide" \
  --mime "text/markdown"

Paid Entry

grapevine entry add "123e4567..." "Premium content here" \
  --title "Advanced Patterns" \
  --paid \
  --price 1500000 \
  --tags advanced,patterns,typescript

JSON Data Entry

grapevine entry add "123e4567..." '{"data": "value"}' \
  --title "API Response" \
  --mime "application/json"

Output

Adding entry to feed...
✅ Entry added: entry-456e7890-abcd-ef12-3456-789012345678
 
📝 Entry Details:
   Title: API Response
   Feed: Tech Blog (123e4567...)
   Type: Free entry
   MIME: application/json
   Content: 18 bytes
   
   View at: https://grapevine.markets/entries/entry-456e7890...

Authentication

Requires authentication and you must own the target feed.

Environment Variable
export PRIVATE_KEY="0xYourPrivateKeyHere"
grapevine entry add "123e4567..." "My content"

Payment

Entry creation requires x402 micropayment (handled automatically). Ensure you have:

  • ETH for gas fees
  • USDC for the payment

Notes

  • Feed Ownership: You must own the feed to add entries
  • Private IPFS Storage: Content stored on Private IPFS, returns content_cid
  • Free vs Paid: Use --paid flag to make entry require payment
  • MIME Detection: Content type auto-detected if not specified

Related Commands