Gatana logoGatana Docs
RoutesArtifacts

/artifacts

Create an artifact from a Markdown or HTML document and return its viewer URL

POST
/artifacts
AuthorizationBearer <token>

In: header

Request Body

application/json

title?string

Title shown in the viewer and the list. When omitted, the first heading of the Markdown or the of the HTML is used

Lengthlength <= 500
html?string

A complete, self-contained HTML document. Give either html or markdown, not both

Length1 <= length <= 52428800
markdown?string

A Markdown document (GitHub flavored). Stored as written and rendered to HTML when served. Give either html or markdown, not both

Length1 <= length <= 10485760
theme?string

Stylesheet linked into the page when it is served. 'gatana' (the default) applies the Gatana fonts, colors and typography to plain HTML; 'none' serves the document as published

Value in"none" | "gatana"

Response Body

application/json

curl -X POST "https://YOUR_ORG_ID.gatana.ai/api/v1/artifacts" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "title": "string",
  "createdByUserId": "string",
  "createdByUserName": "string",
  "createdByUserEmail": "string",
  "visibility": "private",
  "theme": "none",
  "currentVersion": 0,
  "sharedWithUserIds": [
    "string"
  ],
  "sharedWithTeamIds": [
    "string"
  ],
  "createdAt": "string",
  "updatedAt": "string",
  "url": "string"
}