Skip to main content
Share links let you curate a selection of assets into a shareable URL — without moving them out of their collections. Generate images with pixa run, organize them into a share link, and send it to stakeholders.

​
CLI commands

SubcommandDescription
share-links listList all share links
share-links get <id>Get a share link by ID
share-links createCreate a new share link (--name required)
share-links contents <id>List assets in a share link
share-links update <id>Modify a share link
share-links delete <id>Delete a share link

​
MCP actions

The share_links tool supports list, get, create, update, and contents actions. 
pixa share-links list --json

pixa share-links create \
  --name "Summer Collection Lookbook" \
  --asset ast_abc123 \
  --asset ast_def456 \
  --json

​
Create from a collection

pixa share-links create \
  --name "All Product Photos" \
  --collection col_xyz789 \
  --json
When creating a share link, provide either --asset IDs or a --collection — not both.
pixa share-links contents share_abc123 --json
Add or remove assets from an existing share link: 
pixa share-links update share_abc123 \
  --add-asset ast_new789 \
  --remove-asset ast_old123 \
  --json

pixa share-links delete share_abc123 --json

​
End-to-end workflow

Generate images, create a share link, and share it: 
# 1. Generate product images
pixa run model "lifestyle photo of sneakers on a wooden floor" \
  --model nano-banana-2 \
  --num-variations 4 --json

# 2. Process existing photos
pixa run prompt "remove background and upscale 2x" \
  --attachment product.png --json

# 3. Create a share link with the results
pixa share-links create \
  --name "Sneaker Launch Lookbook" \
  --asset ast_abc123 \
  --asset ast_def456 \
  --json

# 4. Get the shareable URL
pixa share-links get share_abc123 --json
Share links are shareable — the URL can be sent directly to reviewers, clients, or team members.

​
Use cases

Product boards — Collect generated and edited product photos into a shareable link for team review. Campaign lookbooks — Generate brand-consistent images with --brand-library, organize them into a share link, and share with creative leads. Client deliverables — Process a batch of assets via a pipeline, then create a share link as the final deliverable.
For more on views and the visual gallery editor, see the Views & Galleries guide.