Create and Share

POST /api/artifacts/share

Create and Share

cURL

curl --request POST \
  --url https://genui.sh/api/artifacts/share \
  --header 'Content-Type: application/json' \
  --data '
{
  "template": "<string>",
  "title": "<string>",
  "content": {},
  "expiresIn": "<string>",
  "allowDownload": true,
  "metadata": {}
}
'

201

{
  "id": "art_abc123",
  "template": "markdown",
  "title": "Quick Note",
  "status": "active",
  "url": "https://genui.sh/a/art_abc123?token=eyJhbGc...",
  "expiresAt": "2024-01-22T12:00:00Z",
  "createdAt": "2024-01-15T12:00:00Z"
}

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

Request

template · string · required

Template type: markdown, chart, table, pdf

title · string

Display title for the artifact

content · object · required

Template-specific content object

expiresIn · string

Expiration for both artifact and share link. Default: 7d

allowDownload · boolean

Allow viewers to download (PDF only). Default: false

metadata · object

Custom metadata key-value pairs

Response

id · string

The artifact ID

url · string

The shareable URL (ready to use immediately)

expiresAt · string

ISO 8601 expiration timestamp

201

{
  "id": "art_abc123",
  "template": "markdown",
  "title": "Quick Note",
  "status": "active",
  "url": "https://genui.sh/a/art_abc123?token=eyJhbGc...",
  "expiresAt": "2024-01-22T12:00:00Z",
  "createdAt": "2024-01-15T12:00:00Z"
}

Code Examples

curl

curl -X POST https://genui.sh/api/artifacts/share \
  -H "Authorization: Bearer $GENUI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "markdown",
    "title": "Quick Note",
    "content": {"text": "# Important Update\n\nHere is the information you requested."},
    "expiresIn": "24h"
  }'

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

Approach	API Calls	Use Case
Create + Share	2	Need artifact ID for future updates
Create and Share	1	One-shot content sharing