Skip to main content
POST
Create and Share
Create an artifact and immediately generate a share URL in a single request. This is the most efficient way to create shareable content.

Request

string
required
Template type: markdown, chart, table, pdf
string
Display title for the artifact
object
required
Template-specific content object
string
Expiration for both artifact and share link. Default: 7d
boolean
Allow viewers to download (PDF only). Default: false
object
Custom metadata key-value pairs

Response

string
The artifact ID
string
The shareable URL (ready to use immediately)
string
ISO 8601 expiration timestamp

Code Examples

Use Cases

This endpoint is ideal for:
  • AI agents that need to share results immediately
  • Automation workflows that generate and distribute content
  • One-off sharing without needing to manage artifact IDs
  • Ephemeral content that should auto-expire

Comparison with Separate Calls