Build creative workflows that survive the request.

curl https://platform.trydesigngen.com/v1/prompts/enhance \
  -H "Authorization: Bearer $DESIGNGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project_…",
    "operation": "generate_with_reference",
    "text": "Make a clean launch graphic",
    "mode": "enhance",
    "lockedText": ["ORBIT CLUB"],
    "references": [
      { "assetId": "asset_…", "role": "style" },
      { "assetId": "asset_…", "role": "logo" }
    ],
    "output": { "resolution": "2K", "aspectRatio": "1:1" }
  }'

// Run this only in your server environment. The browser calls your backend.
const response = await fetch('https://platform.trydesigngen.com/v1/design-analysis', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DESIGNGEN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    imageUrl: 'https://assets.example.test/artwork.png',
    designPrompt: 'One-color shop shirt artwork',
    profile: 'standard',
    printTarget: { width: 12, height: 16, unit: 'in', method: 'dtf' },
    metadata: { externalArtworkId: 'ams-art-42' },
  }),
});

if (!response.ok) throw new Error(`Analysis failed: ${response.status}`);
const { data } = await response.json();
// facts and printAssessment are typed observations; assessment is a suggestion layer.
// The analysis field remains available only as the original flat compatibility projection.
return data;

curl https://platform.trydesigngen.com/v1/vectorizations \
  -H "Authorization: Bearer $DESIGNGEN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project_…",
    "sourceAssetId": "asset_…",
    "profile": "print",
    "formats": ["svg", "pdf", "png"]
  }'

# Enroll in the Operator beta and create a key with
# operator_write, operator_read, and usage_read scopes.
UPLOAD=$(curl -sS https://platform.trydesigngen.com/v1/operator/uploads \
  -H "Authorization: Bearer $DESIGNGEN_API_KEY" \
  -F "file=@artwork.png")
ARTIFACT_ID=$(printf '%s' "$UPLOAD" | jq -r '.artifact_id')

# Save this key and reuse it only when retrying this exact request.
REQUEST_KEY=$(uuidgen)
RUN=$(curl -sS https://platform.trydesigngen.com/v1/operator/runs \
  -H "Authorization: Bearer $DESIGNGEN_API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"workflow\":\"print_file_fix\",\"attachmentRef\":\"$ARTIFACT_ID\",\"targetWidthIn\":12,\"approvalMode\":\"preview\",\"maxCredits\":500,\"modelTier\":\"light_us\"}")
RUN_ID=$(printf '%s' "$RUN" | jq -r '.run.id')

curl -sS "https://platform.trydesigngen.com/v1/operator/runs/$RUN_ID/production-package" \
  -H "Authorization: Bearer $DESIGNGEN_API_KEY"

curl https://platform.trydesigngen.com/v1/developer/webhooks \
  -H "Authorization: Bearer $DESIGNGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project_…",
    "url": "https://api.example.com/webhooks/designgen",
    "events": ["generation.completed", "generation.failed"]
  }'

{
  "success": false,
  "error": {
    "code": "idempotency_conflict",
    "message": "Idempotency key was already used with a different request"
  }
}