create
Queue a new artifact to build a styled web page, PDF, Word, or Excel file from your request or supplied source content; returns artifact, version, and job IDs.
Instructions
Queue a new artifact. Returns artifact_id, version, and job_id immediately. Then call status(job_id, wait=90).
Want a styled page from text you already wrote? Publish that Markdown. It is styled automatically
when format is omitted and no html is passed (format=markdown; style defaults to house).
Want the server to write the page? Pass source_content here.
Raw HTML in publish is shown exactly as given, with no ArtifactSmith styling.
Required: verbatim_request (the user's exact words; the whole scope).
display_name is the human title on cards (optional if slug is set; defaults to the slug;
at most 200 characters; example "Pilot store brief"). slug is the workspace URL key
(optional if display_name is set; otherwise derived from the title; 2-63 chars of a-z, 0-9,
and hyphen, starting with a letter or digit; example "pilot-store-brief"). Provide at least one.
kind defaults to web_static (the only kind in this release).
format is html (default), markdown, pdf, docx, or xlsx. The model writes content. A fixed renderer
writes the bytes. html uses the visual style (house, bold, editorial, playful, terminal, swiss;
default AM_DEFAULT_STYLE, usually house). On markdown, pdf, docx, and xlsx the model prompt does
not use that visual style. A markdown page is still shown in the recorded style when it is opened.
mode is fast or full (default AM_BUILD_MODE, usually full). When mode is omitted and the
style is listed in AM_FAST_STYLES, the default is fast instead. fast applies to a first HTML
build: the model writes Markdown and the server renders it. full is the HTML build.
Other formats ignore fast. An explicit mode still wins. A complete HTML source, or a request
to publish that HTML as-is, stays full when mode is omitted. Mentioning HTML beside "unchanged" does not.
source_content (optional, up to 200 KB total with source_files) is researched material the page
is built from. The builder uses only the request plus this material for facts.
source_files (optional) is a list of {name, content} objects under the same 200 KB cap.
If a needed fact is missing, the job ends as needs_input with a short missing message and stores
no file. Call create again with the same slug after you supply the data.
create does not create a share link. When checks fail, the server retries the model once, so a
failed build takes about twice as long to report as a clean one.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | web_static | |
| mode | No | Build mode for a first HTML page: fast or full. fast writes Markdown and the server renders the style. full is the HTML build. Default is AM_BUILD_MODE (full), or fast when the style is listed in AM_FAST_STYLES. A complete HTML source, or a request to publish that HTML as-is, stays full when mode is omitted. Mentioning HTML next to unchanged does not. Other formats ignore fast. | |
| slug | No | URL key unique in the workspace. Optional if display_name is set (then derived from the title: lowercase, accents folded, other characters become hyphens). 2-63 characters of a-z, 0-9, and hyphen; must start with a letter or digit. Example: "pilot-store-brief". Provide display_name or slug (at least one). | |
| model | No | ||
| style | No | ||
| format | No | ||
| workspace | No | ||
| capabilities | No | ||
| display_name | No | Human title shown on cards and in the catalog. Optional if slug is set (then it defaults to the slug). At most 200 characters. Example: "Pilot store brief". Provide display_name or slug (at least one). | |
| source_files | No | ||
| source_content | No | ||
| idempotency_key | No | ||
| verbatim_request | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||