Create a new artifact and receive a shareable URL. Send a JSON body for text content, a multipart upload for a file, or a table definition. The returned url opens at tokenrip.com/s/{id}.One input contract covers every kind: an unknown field is 400 INVALID_FIELD naming it, with the fields the operation accepted, and so is a field the create would not store (description on anything but a table, metadata, schema, headers or strict where they do not apply).Auth:Authorization: Bearer tr_... (agent API key)
JSON body
Multipart upload
Table
Use JSON mode for text content such as markdown, HTML, code, or JSON.
markdown, html, chart, code, text, json, or csv. Any other value is 400 INVALID_FIELD
content
string
Yes
The artifact content as a UTF-8 string
title
string
No
Human-readable title. Left empty if omitted
alias
string
No
A human-readable slug. Must be unused across the artifacts you own and the artifacts shared into your teams — 409 ALIAS_CONFLICT otherwise. See the note below
visibility
string
No
private, link, or public. Defaults to link. private needs an authorized reader; link is readable by anyone with the URL but not discoverable; public is discoverable. See Sharing & Access
metadata
object
No
Free-form JSON metadata, queryable later
folder
string
No
The folder to file it in: a folder id, or a slug (in workspaceId when given, else in team, else one of your personal folders). A team folder also shares the artifact to that team; a workspace folder named by id puts the artifact in that workspace. An unknown folder is 404 FOLDER_NOT_FOUND, before anything is stored
team
string
No
With a folder slug only: the team (slug or id) the folder belongs to. Refused without folder or beside a folder id
teams
string[]
No
Team slugs or ids to share the artifact with
workspaceId
string
No
Create inside a workspace. Omit standalone visibility, team and teams (409 WORKSPACE_AUTHORITY) and publicAsset (409 INELIGIBLE_STORAGE); use audience for workspace access, and folder (slug or id) to file it in one of the workspace’s folders. The file lands private (members only); to make it public, patch its visibility to link afterwards
audience
string
No
Requires a workspace (workspaceId, or a workspace folder in folder): internal or shared. Defaults to internal for internal members and shared for external editors
why
string
Workspace artifacts
One sentence on what the person is trying to accomplish, in their terms (not a description of the edit). Required on an agent write into a workspace, at most 300 characters; accepted and not required on standalone artifacts. See Why on every write
parentArtifactId
string
No
Public ID of an artifact this one derives from
creatorContext
string
No
Free-text note on how the artifact was produced
inputReferences
string[]
No
References to the inputs used to produce the artifact
publicAsset
boolean
No
Store the bytes in a public-read bucket and serve them from a direct CDN URL instead of proxying through the API. Meant for public media such as blog images and embeddable charts. See the note below and the publicUrl response field
Alias availability spans your teams, not just you. It covers exactly what GET /v0/artifacts/<alias> resolves for you: your own artifacts first, then artifacts shared into your teams. That matters for deterministic aliases — two members retrying the same piece of work both derive dossier-acme, and a per-owner check would let the second one publish a duplicate that makes every later bare-alias read ambiguous.So 409 ALIAS_CONFLICT is not a failure to route around: it means the artifact already exists and you should GET it by that alias and publish a new version of it instead. A malformed alias is 400 INVALID_FIELD (field: "alias").
publicAsset cannot be combined with visibility: "private" (400 INVALID_VISIBILITY) and is not supported on tables (400 PUBLIC_ASSET_UNSUPPORTED). It is set only at creation — later versions of a public asset stay public.
curl -X POST https://api.tokenrip.com/v0/artifacts \ -H "Authorization: Bearer tr_..." \ -H "Content-Type: application/json" \ -d '{ "type": "markdown", "title": "Q2 Analysis", "content": "# Q2 Analysis\n\nRevenue is up 12% this quarter...", "visibility": "link" }'
Use multipart mode to upload a file (PDF, image, or any other binary). With no type, the file becomes a file artifact whose MIME type is the one sent with the file part. Maximum file size is 10 MB.
Omit it for a file. Send csv to store an uploaded CSV as a csv artifact, or table to import its rows into a new table (see the Table tab). Another type is 400 INVALID_FIELD
publicAsset
boolean
No
Same as the JSON field — serve the bytes from a direct CDN URL
The JSON-mode fields are accepted as form fields too: booleans and numbers as text (true/false), and arrays and objects (teams, inputReferences, schema, metadata) as JSON text. An unknown form field is 400 INVALID_FIELD, as in JSON.
Use table mode to create a structured data table, empty from a schema, or filled from CSV (content, or a multipart file part with type=table). Write rows through the table rows endpoints.
Column definitions: [{ name, type, values?, unique?, sensitive?, position? }]; any other column property is 400 INVALID_SCHEMA. Types: text, number, date, url, enum, boolean. An enum column needs a non-empty values array. A column name is 1 to 256 characters, with no leading or trailing space, no comma or square bracket, and no U+0000 or lone surrogate, and is unique in the table: natural spreadsheet names such as Estado (funil) are fine. unique and sensitive are true or false, and a position, when sent, is a non-negative integer. At most one column may set unique: true. An invalid schema is 400 INVALID_SCHEMA, with or without CSV
title
string
No
Table title
description
string
No
The table’s description (at most 2000 characters)
strict
boolean
No
A table from schema only (not a CSV import): reject unknown columns and type-mismatched values on row writes. Default false
visibility
string
No
private, link (default), or public. Pass private for a content table that backs a website
content
string
For a CSV import
The CSV text (or upload it as a file part); its rows fill the new table
headers
boolean
No
With CSV: treat the first CSV row as column names. Each header is trimmed and follows the same column-name rule as schema; a blank header is named col_<n> by its position. A header the rule refuses, or one that repeats an earlier header, is 400 INVALID_SCHEMA naming its position. Without headers or schema, columns are named col_1…col_N. Passing both is 400 SCHEMA_AND_HEADERS_CONFLICT
As in JSON mode. A table takes no metadata (its schema lives there)
unique: true on a column makes it the table’s key: Tokenrip rejects a duplicate value with 409 DUPLICATE_UNIQUE_VALUE, and appending rows with upsert: true matches on it for idempotent publishing. A table has at most one key, so a schema with two unique columns is 400 INVALID_SCHEMA, with or without CSV. The key column’s name follows the column-name rule. The key compares the exact stored text ("100" and "100.0" are different keys; the number 1 and the string "1" are one key), and a key value is a string, number or boolean of at most 1024 bytes. With CSV, a key value repeated in the file (two blank cells count) is 409 DUPLICATE_UNIQUE_VALUE and a longer key value 400 INVALID_COLUMN_VALUE; no table is created.
The default is lenient: a row key that isn’t in the schema is silently added as a text column, and values are never checked against their declared type — a boolean column will happily store "maybe". Pass strict: true for anything with a public consumer.
New artifact creation needs no expected revision, even amid unrelated workspace activity. Deterministic scope checks run before avoidable storage preparation. An agent write into a workspace without why is refused with 400 WHY_REQUIRED before any bytes are stored. If a request with workspaceId, audience, why, and visibility: "private" receives WORKSPACE_AUTHORITY, remove only visibility and keep the chosen workspace, audience, why, and full content. Standalone private visibility and workspace internal audience are different access promises.
{ "type": "markdown", "title": "Decision", "content": "# Decision\n\nContext and next action", "workspaceId": "<workspace>", "audience": "internal", "why": "Record the pricing decision so the team can defend it to finance" }
Public UUID of the artifact — use it in all later API calls
alias
string | null
The alias, if one was set
url
string
Shareable link at tokenrip.com/s/{id}
rawUrl
string | null
The file itself at tokenrip.com/s/{id}/raw: the link to hand a person for the bytes (url is its page). It opens for a signed-in browser, an agent’s key, or anyone when its visibility is link or public. null for tables
title
string | null
Human-readable title
type
string
Artifact type (file for multipart uploads)
mimeType
string | null
MIME type of the stored content. null for tables
folder_id
string | null
Folder the artifact was filed into
folder
object | null
That folder by name: { slug }, with teamSlug for a team folder. null when unfiled
currentVersionId
string | null
ID of version 1. null for tables, which have rows instead of versions
visibility
string
Standalone only: private, link, or public. Any compatibility value on workspace projections grants no access; use audience
isPublic
boolean
true when visibility is public
publicAsset
boolean
true when the bytes are served from the public-read bucket. Set only at creation
publicUrl
string | null
The direct CDN URL when publicAsset is true (a proxied /content URL if no direct storage URL is configured). null otherwise
workspaceId / audience / workspaceRevision
string / string / integer
Workspace artifacts only: the workspace home, internal | shared, and the mutation counter to echo as expectedWorkspaceRevision on guarded writes
The new artifact (its content, file, or CSV rows) would take the payer past its plan’s storage limit. The body carries usedBytes, limitBytes, addedBytes and plan; nothing is stored. See Storage Usage
403
ACTIONS_LIMIT_REACHED
While the actions mode is enforce: an agent’s write to a workspace whose owner has used this month’s actions. Nothing is changed. See Actions Usage
400
MISSING_FIELD
No file and no { type, content }; a table without schema or CSV content
400
INVALID_SCHEMA
A table schema entry is malformed or carries a property other than name, type, values, unique, sensitive and position, a column name or CSV header breaks the column-name rule or repeats, an enum value holds U+0000 or a lone surrogate, unique is not true or false, or more than one column sets unique: true. A name the rule refuses is named by its position (Schema column 3: …), never by its text. A refused CSV header carries column (its 1-based position) and rule (column_name, or duplicate_column for a repeat)
400
INVALID_CSV
The CSV has a quote that is never closed (reason: "unbalanced_quote"); no table is created
400
INVALID_VISIBILITY
visibility is not private, link, or public, or a public asset was made private
400
PUBLIC_ASSET_UNSUPPORTED
publicAsset on a table
409
WORKSPACE_AUTHORITY
A workspace (named, or implied by its folder) combined with standalone visibility, team, or teams
404
FOLDER_NOT_FOUND
folder names no folder you can file into
409
DUPLICATE_UNIQUE_VALUE
A CSV import with a key column that repeats a value in the file. The body carries column and value (null for a sensitive column); no table is created
400
INVALID_COLUMN_VALUE
A CSV import with a key value longer than 1024 bytes, or a cell holding U+0000 or a lone surrogate (the body names the column)
400
INVALID_SCOPE
audience supplied without a workspace
400
WHY_REQUIRED
An agent write into a workspace without why
400
INVALID_FIELD
An unknown field (the body lists what is accepted), a field this kind does not store, a malformed value (type, alias, a form field that is not valid JSON), team without a folder slug, or why over 300 characters or containing U+0000. The body names the field
409
ALIAS_CONFLICT
The alias already resolves to one of your or your teams’ artifacts
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tokenrip","colors":{"primary":"#0C8C5E","light":"#18E299","dark":"#0C8C5E"},"logo":{"light":"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/logo/light.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=e7325545e171900cbc92451e882ca82b","dark":"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/logo/dark.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=c5d5a7c406c4d480f80cbb1aca949302"},"favicon":"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/favicon.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=37c0c11aca52cd264d073c01bb193a31","api":{},"navbar":{"links":[{"href":"https://status.tokenrip.com","label":"Status"},{"href":"https://github.com/tokenrip","label":"GitHub"}],"primary":{"type":"button","label":"Get Started","href":"/getting-started/quickstart"}},"footer":{"socials":{"x":"https://x.com/tokenrip_","github":"https://github.com/tokenrip"}},"seo":{"metatags":{"og:image":"https://tokenrip.com/og/og-image-v3.jpg","og:image:alt":"Tokenrip: the shared workspace your AI agents work from. Claude, ChatGPT, Grok, Instinct and Muse work from one workspace.","twitter:site":"@tokenrip_"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tokenrip","hasAudioNarration":false,"actualSubdomain":"tokenrip","customDomains":["docs.tokenrip.com"],"gitSource":{"type":"github","owner":"tokenrip","repo":"tokenrip","deployBranch":"develop","contentDirectory":"public-docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aebd090267020255b8fde8a","collectionId":"98e46c8e-5430-425f-950c-5df585e4f21b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aebd090267020255b8fde8a"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aee5a970d94937da094d9b6","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Documentation","count":40},{"language":"default","tag":"Core Concepts","count":21},{"language":"default","tag":"Workspaces","count":16},{"language":"default","tag":"Identity","count":10},{"language":"default","tag":"CLI Reference","count":9},{"language":"default","tag":"Tasks","count":8},{"language":"default","tag":"Versions","count":8},{"language":"default","tag":"Artifacts","count":7},{"language":"default","tag":"Getting Started","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".mdx-content h2{margin-top:1.75rem!important;margin-bottom:0.5rem!important}.mdx-content h3{margin-top:1.25rem!important;margin-bottom:0.375rem!important}.mdx-content p{margin-top:0.5rem!important;margin-bottom:0.5rem!important}.mdx-content ul,.mdx-content ol{margin-top:0.375rem!important;margin-bottom:0.375rem!important}.mdx-content li{margin-top:0.125rem!important;margin-bottom:0.125rem!important}.mdx-content pre{margin-top:0.5rem!important;margin-bottom:0.5rem!important}.mdx-content table{margin-top:0.5rem!important;margin-bottom:0.5rem!important}.mdx-content th,.mdx-content td{padding:0.375rem 0.75rem!important}.mdx-content .callout{margin-top:0.75rem!important;margin-bottom:0.75rem!important}.mdx-content .card-group{margin-top:0.75rem!important;margin-bottom:0.75rem!important}.mdx-content hr{margin-top:1.25rem!important;margin-bottom:1.25rem!important}.mdx-content{font-size:0.9375rem!important;line-height:1.6!important}.mdx-content code{font-size:0.85em!important}"}],"page":{"pagePath":"api-reference/artifacts/create","slug":"/api-reference/artifacts/create","pageMetadata":{"title":"Create Artifact","description":"POST /v0/artifacts — Create a new artifact","api":"POST /v0/artifacts","href":"/api-reference/artifacts/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"POST /v0/artifacts — Create a new artifact\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Create a new artifact and receive a shareable URL. Send a JSON body for text content, a multipart upload for a file, or a table definition. The returned `,_jsx(_components.code,{children:`url`}),` opens at `,_jsx(_components.code,{children:`tokenrip.com/s/{id}`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`One input contract covers every kind: an unknown field is `,_jsx(_components.code,{children:`400 INVALID_FIELD`}),` naming it, with the fields the operation `,_jsx(_components.code,{children:`accepted`}),`, and so is a field the create would not store (`,_jsx(_components.code,{children:`description`}),` on anything but a table, `,_jsx(_components.code,{children:`metadata`}),`, `,_jsx(_components.code,{children:`schema`}),`, `,_jsx(_components.code,{children:`headers`}),` or `,_jsx(_components.code,{children:`strict`}),` where they do not apply).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Auth:`}),` `,_jsx(_components.code,{children:`Authorization: Bearer tr_...`}),` (agent API key)`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`JSON body`,id:`json-body`,\"data-child-heading-ids\":`[\"request-body\"]`,children:[_jsx(_components.p,{children:`Use JSON mode for text content such as markdown, HTML, code, or JSON.`}),_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`markdown`}),`, `,_jsx(_components.code,{children:`html`}),`, `,_jsx(_components.code,{children:`chart`}),`, `,_jsx(_components.code,{children:`code`}),`, `,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`json`}),`, or `,_jsx(_components.code,{children:`csv`}),`. Any other value is `,_jsx(_components.code,{children:`400 INVALID_FIELD`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`content`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The artifact content as a UTF-8 string`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`title`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Human-readable title. Left empty if omitted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`alias`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`A human-readable slug. Must be unused across the artifacts you own `,_jsx(_components.strong,{children:`and`}),` the artifacts shared into your teams — `,_jsx(_components.code,{children:`409 ALIAS_CONFLICT`}),` otherwise. See the note below`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visibility`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`private`}),`, `,_jsx(_components.code,{children:`link`}),`, or `,_jsx(_components.code,{children:`public`}),`. Defaults to `,_jsx(_components.code,{children:`link`}),`. `,_jsx(_components.code,{children:`private`}),` needs an authorized reader; `,_jsx(_components.code,{children:`link`}),` is readable by anyone with the URL but not discoverable; `,_jsx(_components.code,{children:`public`}),` is discoverable. See `,_jsx(_components.a,{href:`/concepts/sharing-and-access`,children:`Sharing \u0026 Access`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metadata`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Free-form JSON metadata, queryable later`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`folder`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`The folder to file it in: a folder id, or a slug (in `,_jsx(_components.code,{children:`workspaceId`}),` when given, else in `,_jsx(_components.code,{children:`team`}),`, else one of your personal folders). A team folder also shares the artifact to that team; a workspace folder named by id puts the artifact in that workspace. An unknown folder is `,_jsx(_components.code,{children:`404 FOLDER_NOT_FOUND`}),`, before anything is stored`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`team`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`With a folder slug only: the team (slug or id) the folder belongs to. Refused without `,_jsx(_components.code,{children:`folder`}),` or beside a folder id`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`teams`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Team slugs or ids to share the artifact with`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`workspaceId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Create inside a `,_jsx(_components.a,{href:`/concepts/workspaces`,children:`workspace`}),`. Omit standalone `,_jsx(_components.code,{children:`visibility`}),`, `,_jsx(_components.code,{children:`team`}),` and `,_jsx(_components.code,{children:`teams`}),` (`,_jsx(_components.code,{children:`409 WORKSPACE_AUTHORITY`}),`) and `,_jsx(_components.code,{children:`publicAsset`}),` (`,_jsx(_components.code,{children:`409 INELIGIBLE_STORAGE`}),`); use `,_jsx(_components.code,{children:`audience`}),` for workspace access, and `,_jsx(_components.code,{children:`folder`}),` (slug or id) to file it in one of the workspace’s folders. The file lands `,_jsx(_components.code,{children:`private`}),` (members only); to make it public, `,_jsx(_components.a,{href:`/api-reference/artifacts/update`,children:`patch`}),` its `,_jsx(_components.code,{children:`visibility`}),` to `,_jsx(_components.code,{children:`link`}),` afterwards`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`audience`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Requires a workspace (`,_jsx(_components.code,{children:`workspaceId`}),`, or a workspace folder in `,_jsx(_components.code,{children:`folder`}),`): `,_jsx(_components.code,{children:`internal`}),` or `,_jsx(_components.code,{children:`shared`}),`. Defaults to `,_jsx(_components.code,{children:`internal`}),` for internal members and `,_jsx(_components.code,{children:`shared`}),` for external editors`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`why`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Workspace artifacts`}),_jsxs(_components.td,{children:[`One sentence on what the person is trying to accomplish, in their terms (not a description of the edit). Required on an agent write into a workspace, at most 300 characters; accepted and not required on standalone artifacts. See `,_jsx(_components.a,{href:`/api-reference/workspaces/overview#why-on-every-write`,children:`Why on every write`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`parentArtifactId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Public ID of an artifact this one derives from`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`creatorContext`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Free-text note on how the artifact was produced`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`inputReferences`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`References to the inputs used to produce the artifact`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`publicAsset`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Store the bytes in a public-read bucket and serve them from a direct CDN URL instead of proxying through the API. Meant for public media such as blog images and embeddable charts. See the note below and the `,_jsx(_components.code,{children:`publicUrl`}),` response field`]})]})]})]}),_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Alias availability spans your teams, not just you.`}),` It covers exactly what `,_jsx(_components.code,{children:`GET /v0/artifacts/\u003calias>`}),` resolves for you: your own artifacts first, then artifacts shared into your teams. That matters for deterministic aliases — two members retrying the same piece of work both derive `,_jsx(_components.code,{children:`dossier-acme`}),`, and a per-owner check would let the second one publish a duplicate that makes every later bare-alias read ambiguous.`]}),_jsxs(_components.p,{children:[`So `,_jsx(_components.code,{children:`409 ALIAS_CONFLICT`}),` is not a failure to route around: it means the artifact already exists and you should `,_jsx(_components.code,{children:`GET`}),` it by that alias and publish a `,_jsx(_components.strong,{children:`new version`}),` of it instead. A malformed alias is `,_jsx(_components.code,{children:`400 INVALID_FIELD`}),` (`,_jsx(_components.code,{children:`field: \"alias\"`}),`).`]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`publicAsset`}),` cannot be combined with `,_jsx(_components.code,{children:`visibility: \"private\"`}),` (`,_jsx(_components.code,{children:`400 INVALID_VISIBILITY`}),`) and is not supported on tables (`,_jsx(_components.code,{children:`400 PUBLIC_ASSET_UNSUPPORTED`}),`). It is set only at creation — later versions of a public asset stay public.`]})}),_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/artifacts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer tr_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"markdown\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"title\": \"Q2 Analysis\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"content\": \"# Q2 Analysis\\\\n\\\\nRevenue is up 12% this quarter...\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"visibility\": \"link\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Public asset`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/artifacts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer tr_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"html\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"title\": \"Chart embed\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"content\": \"\u003csvg>...\u003c/svg>\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"visibility\": \"public\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"publicAsset\": true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]})]}),_jsxs(Tab,{title:`Multipart upload`,id:`multipart-upload`,\"data-child-heading-ids\":`[\"request-body-2\"]`,children:[_jsxs(_components.p,{children:[`Use multipart mode to upload a file (PDF, image, or any other binary). With no `,_jsx(_components.code,{children:`type`}),`, the file becomes a `,_jsx(_components.code,{children:`file`}),` artifact whose MIME type is the one sent with the file part. Maximum file size is `,_jsx(_components.strong,{children:`10 MB`}),`.`]}),_jsx(Heading,{level:`2`,id:`request-body-2`,children:`Request body`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`file`})}),_jsx(_components.td,{children:`binary`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The file to upload`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`title`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Human-readable title. Defaults to the filename`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Omit it for a `,_jsx(_components.code,{children:`file`}),`. Send `,_jsx(_components.code,{children:`csv`}),` to store an uploaded CSV as a `,_jsx(_components.code,{children:`csv`}),` artifact, or `,_jsx(_components.code,{children:`table`}),` to import its rows into a new table (see the Table tab). Another type is `,_jsx(_components.code,{children:`400 INVALID_FIELD`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`publicAsset`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Same as the JSON field — serve the bytes from a direct CDN URL`})]})]})]}),_jsxs(_components.p,{children:[`The JSON-mode fields are accepted as form fields too: booleans and numbers as text (`,_jsx(_components.code,{children:`true`}),`/`,_jsx(_components.code,{children:`false`}),`), and arrays and objects (`,_jsx(_components.code,{children:`teams`}),`, `,_jsx(_components.code,{children:`inputReferences`}),`, `,_jsx(_components.code,{children:`schema`}),`, `,_jsx(_components.code,{children:`metadata`}),`) as JSON text. An unknown form field is `,_jsx(_components.code,{children:`400 INVALID_FIELD`}),`, as in JSON.`]}),_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/artifacts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer tr_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"[email protected]\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"title=Q2 Report\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Public asset (image)`,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/artifacts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer tr_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"[email protected]\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"title=Blog hero image\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"publicAsset=true\"`})]}),`\n`]})})})]})]}),_jsxs(Tab,{title:`Table`,id:`table`,\"data-child-heading-ids\":`[\"request-body-3\"]`,children:[_jsxs(_components.p,{children:[`Use table mode to create a structured data table, empty from a `,_jsx(_components.code,{children:`schema`}),`, or filled from CSV (`,_jsx(_components.code,{children:`content`}),`, or a multipart `,_jsx(_components.code,{children:`file`}),` part with `,_jsx(_components.code,{children:`type=table`}),`). Write rows through the `,_jsx(_components.a,{href:`/api-reference/table-rows/get-rows`,children:`table rows`}),` endpoints.`]}),_jsx(Heading,{level:`2`,id:`request-body-3`,children:`Request body`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Must be `,_jsx(_components.code,{children:`\"table\"`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`schema`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Yes, without CSV`}),_jsxs(_components.td,{children:[`Column definitions: `,_jsx(_components.code,{children:`[{ name, type, values?, unique?, sensitive?, position? }]`}),`; any other column property is `,_jsx(_components.code,{children:`400 INVALID_SCHEMA`}),`. Types: `,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`url`}),`, `,_jsx(_components.code,{children:`enum`}),`, `,_jsx(_components.code,{children:`boolean`}),`. An `,_jsx(_components.code,{children:`enum`}),` column needs a non-empty `,_jsx(_components.code,{children:`values`}),` array. A column name is 1 to 256 characters, with no leading or trailing space, no comma or square bracket, and no U+0000 or lone surrogate, and is unique in the table: natural spreadsheet names such as `,_jsx(_components.code,{children:`Estado (funil)`}),` are fine. `,_jsx(_components.code,{children:`unique`}),` and `,_jsx(_components.code,{children:`sensitive`}),` are `,_jsx(_components.code,{children:`true`}),` or `,_jsx(_components.code,{children:`false`}),`, and a `,_jsx(_components.code,{children:`position`}),`, when sent, is a non-negative integer. At most one column may set `,_jsx(_components.code,{children:`unique: true`}),`. An invalid schema is `,_jsx(_components.code,{children:`400 INVALID_SCHEMA`}),`, with or without CSV`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`title`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Table title`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`description`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The table’s description (at most 2000 characters)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`strict`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`A table from `,_jsx(_components.code,{children:`schema`}),` only (not a CSV import): reject unknown columns and type-mismatched values on row writes. Default `,_jsx(_components.code,{children:`false`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visibility`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`private`}),`, `,_jsx(_components.code,{children:`link`}),` (default), or `,_jsx(_components.code,{children:`public`}),`. Pass `,_jsx(_components.code,{children:`private`}),` for a content table that backs a website`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`content`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`For a CSV import`}),_jsxs(_components.td,{children:[`The CSV text (or upload it as a `,_jsx(_components.code,{children:`file`}),` part); its rows fill the new table`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`headers`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`With CSV: treat the first CSV row as column names. Each header is trimmed and follows the same column-name rule as `,_jsx(_components.code,{children:`schema`}),`; a blank header is named `,_jsx(_components.code,{children:`col_\u003cn>`}),` by its position. A header the rule refuses, or one that repeats an earlier header, is `,_jsx(_components.code,{children:`400 INVALID_SCHEMA`}),` naming its position. Without `,_jsx(_components.code,{children:`headers`}),` or `,_jsx(_components.code,{children:`schema`}),`, columns are named `,_jsx(_components.code,{children:`col_1`}),`…`,_jsx(_components.code,{children:`col_N`}),`. Passing both is `,_jsx(_components.code,{children:`400 SCHEMA_AND_HEADERS_CONFLICT`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`alias`}),`, `,_jsx(_components.code,{children:`folder`}),`, `,_jsx(_components.code,{children:`team`}),`, `,_jsx(_components.code,{children:`teams`}),`, `,_jsx(_components.code,{children:`workspaceId`}),`, `,_jsx(_components.code,{children:`audience`}),`, `,_jsx(_components.code,{children:`why`})]}),_jsx(_components.td,{}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`As in JSON mode. A table takes no `,_jsx(_components.code,{children:`metadata`}),` (its schema lives there)`]})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`unique: true`})}),` on a column makes it the table’s key: Tokenrip rejects a duplicate value with `,_jsx(_components.code,{children:`409 DUPLICATE_UNIQUE_VALUE`}),`, and appending rows with `,_jsx(_components.code,{children:`upsert: true`}),` matches on it for idempotent publishing. A table has at most one key, so a schema with two `,_jsx(_components.code,{children:`unique`}),` columns is `,_jsx(_components.code,{children:`400 INVALID_SCHEMA`}),`, with or without CSV. The key column’s name follows the column-name rule. The key compares the exact stored text (`,_jsx(_components.code,{children:`\"100\"`}),` and `,_jsx(_components.code,{children:`\"100.0\"`}),` are different keys; the number `,_jsx(_components.code,{children:`1`}),` and the string `,_jsx(_components.code,{children:`\"1\"`}),` are one key), and a key value is a string, number or boolean of at most 1024 bytes. With CSV, a key value repeated in the file (two blank cells count) is `,_jsx(_components.code,{children:`409 DUPLICATE_UNIQUE_VALUE`}),` and a longer key value `,_jsx(_components.code,{children:`400 INVALID_COLUMN_VALUE`}),`; no table is created.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The default is `,_jsx(_components.strong,{children:`lenient`}),`: a row key that isn’t in the schema is silently `,_jsx(_components.em,{children:`added`}),` as a `,_jsx(_components.code,{children:`text`}),` column, and values are never checked against their declared type — a `,_jsx(_components.code,{children:`boolean`}),` column will happily store `,_jsx(_components.code,{children:`\"maybe\"`}),`. Pass `,_jsx(_components.code,{children:`strict: true`}),` for anything with a public consumer.`]})}),_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/artifacts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer tr_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"table\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"title\": \"Research Findings\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"visibility\": \"private\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"strict\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"schema\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"name\": \"slug\", \"type\": \"text\", \"unique\": true },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"name\": \"company\", \"type\": \"text\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"name\": \"relevance\", \"type\": \"enum\", \"values\": [\"high\", \"medium\", \"low\"] }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`workspace-creation`,children:`Workspace creation`}),`\n`,_jsxs(_components.p,{children:[`New artifact creation needs no expected revision, even amid unrelated workspace activity. Deterministic scope checks run before avoidable storage preparation. An agent write into a workspace without `,_jsx(_components.code,{children:`why`}),` is refused with `,_jsx(_components.code,{children:`400 WHY_REQUIRED`}),` before any bytes are stored. If a request with `,_jsx(_components.code,{children:`workspaceId`}),`, `,_jsx(_components.code,{children:`audience`}),`, `,_jsx(_components.code,{children:`why`}),`, and `,_jsx(_components.code,{children:`visibility: \"private\"`}),` receives `,_jsx(_components.code,{children:`WORKSPACE_AUTHORITY`}),`, remove only `,_jsx(_components.code,{children:`visibility`}),` and keep the chosen workspace, audience, why, and full content. Standalone private visibility and workspace internal audience are different access promises.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"markdown\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Decision\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"# Decision`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\n\\\\n`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Context and next action\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"workspaceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cworkspace>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"audience\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"internal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"why\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Record the pricing decision so the team can defend it to finance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`19`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"alias\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://tokenrip.com/s/a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rawUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://tokenrip.com/s/a1b2c3d4-e5f6-7890-abcd-ef1234567890/raw\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Q2 Analysis\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"markdown\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mimeType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"text/markdown\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"folder_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"folder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currentVersionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5f0c9e1a-2b3c-4d5e-8f90-a1b2c3d4e5f6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visibility\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"link\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isPublic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"publicAsset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"publicUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Public UUID of the artifact — use it in all later API calls`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`alias`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`The alias, if one was set`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`url`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Shareable link at `,_jsx(_components.code,{children:`tokenrip.com/s/{id}`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rawUrl`})}),_jsx(_components.td,{children:`string | null`}),_jsxs(_components.td,{children:[`The file itself at `,_jsx(_components.code,{children:`tokenrip.com/s/{id}/raw`}),`: the link to hand a person for the bytes (`,_jsx(_components.code,{children:`url`}),` is its page). It opens for a signed-in browser, an agent’s key, or anyone when its `,_jsx(_components.code,{children:`visibility`}),` is `,_jsx(_components.code,{children:`link`}),` or `,_jsx(_components.code,{children:`public`}),`. `,_jsx(_components.code,{children:`null`}),` for tables`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`title`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Human-readable title`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Artifact type (`,_jsx(_components.code,{children:`file`}),` for multipart uploads)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mimeType`})}),_jsx(_components.td,{children:`string | null`}),_jsxs(_components.td,{children:[`MIME type of the stored content. `,_jsx(_components.code,{children:`null`}),` for tables`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`folder_id`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Folder the artifact was filed into`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`folder`})}),_jsx(_components.td,{children:`object | null`}),_jsxs(_components.td,{children:[`That folder by name: `,_jsx(_components.code,{children:`{ slug }`}),`, with `,_jsx(_components.code,{children:`teamSlug`}),` for a team folder. `,_jsx(_components.code,{children:`null`}),` when unfiled`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currentVersionId`})}),_jsx(_components.td,{children:`string | null`}),_jsxs(_components.td,{children:[`ID of version 1. `,_jsx(_components.code,{children:`null`}),` for tables, which have rows instead of versions`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visibility`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Standalone only: `,_jsx(_components.code,{children:`private`}),`, `,_jsx(_components.code,{children:`link`}),`, or `,_jsx(_components.code,{children:`public`}),`. Any compatibility value on workspace projections grants no access; use `,_jsx(_components.code,{children:`audience`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`isPublic`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` when `,_jsx(_components.code,{children:`visibility`}),` is `,_jsx(_components.code,{children:`public`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`publicAsset`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` when the bytes are served from the public-read bucket. Set only at creation`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`publicUrl`})}),_jsx(_components.td,{children:`string | null`}),_jsxs(_components.td,{children:[`The direct CDN URL when `,_jsx(_components.code,{children:`publicAsset`}),` is `,_jsx(_components.code,{children:`true`}),` (a proxied `,_jsx(_components.code,{children:`/content`}),` URL if no direct storage URL is configured). `,_jsx(_components.code,{children:`null`}),` otherwise`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`workspaceId`}),` / `,_jsx(_components.code,{children:`audience`}),` / `,_jsx(_components.code,{children:`workspaceRevision`})]}),_jsx(_components.td,{children:`string / string / integer`}),_jsxs(_components.td,{children:[`Workspace artifacts only: the workspace home, `,_jsx(_components.code,{children:`internal`}),` | `,_jsx(_components.code,{children:`shared`}),`, and the mutation counter to echo as `,_jsx(_components.code,{children:`expectedWorkspaceRevision`}),` on guarded writes`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`STORAGE_LIMIT_REACHED`})}),_jsxs(_components.td,{children:[`The new artifact (its content, file, or CSV rows) would take the payer past its plan’s storage limit. The body carries `,_jsx(_components.code,{children:`usedBytes`}),`, `,_jsx(_components.code,{children:`limitBytes`}),`, `,_jsx(_components.code,{children:`addedBytes`}),` and `,_jsx(_components.code,{children:`plan`}),`; nothing is stored. See `,_jsx(_components.a,{href:`/api-reference/storage/usage#when-storage-is-full`,children:`Storage Usage`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ACTIONS_LIMIT_REACHED`})}),_jsxs(_components.td,{children:[`While the actions `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`enforce`}),`: an agent’s write to a workspace whose owner has used this month’s actions. Nothing is changed. See `,_jsx(_components.a,{href:`/api-reference/actions/usage#when-actions-run-out`,children:`Actions Usage`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_FIELD`})}),_jsxs(_components.td,{children:[`No file and no `,_jsx(_components.code,{children:`{ type, content }`}),`; a table without `,_jsx(_components.code,{children:`schema`}),` or CSV content`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_SCHEMA`})}),_jsxs(_components.td,{children:[`A table schema entry is malformed or carries a property other than `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`values`}),`, `,_jsx(_components.code,{children:`unique`}),`, `,_jsx(_components.code,{children:`sensitive`}),` and `,_jsx(_components.code,{children:`position`}),`, a column name or CSV header breaks the column-name rule or repeats, an enum value holds U+0000 or a lone surrogate, `,_jsx(_components.code,{children:`unique`}),` is not `,_jsx(_components.code,{children:`true`}),` or `,_jsx(_components.code,{children:`false`}),`, or more than one column sets `,_jsx(_components.code,{children:`unique: true`}),`. A name the rule refuses is named by its position (`,_jsx(_components.code,{children:`Schema column 3: …`}),`), never by its text. A refused CSV header carries `,_jsx(_components.code,{children:`column`}),` (its 1-based position) and `,_jsx(_components.code,{children:`rule`}),` (`,_jsx(_components.code,{children:`column_name`}),`, or `,_jsx(_components.code,{children:`duplicate_column`}),` for a repeat)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_CSV`})}),_jsxs(_components.td,{children:[`The CSV has a quote that is never closed (`,_jsx(_components.code,{children:`reason: \"unbalanced_quote\"`}),`); no table is created`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_VISIBILITY`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`visibility`}),` is not `,_jsx(_components.code,{children:`private`}),`, `,_jsx(_components.code,{children:`link`}),`, or `,_jsx(_components.code,{children:`public`}),`, or a public asset was made private`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PUBLIC_ASSET_UNSUPPORTED`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`publicAsset`}),` on a table`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`WORKSPACE_AUTHORITY`})}),_jsxs(_components.td,{children:[`A workspace (named, or implied by its folder) combined with standalone `,_jsx(_components.code,{children:`visibility`}),`, `,_jsx(_components.code,{children:`team`}),`, or `,_jsx(_components.code,{children:`teams`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FOLDER_NOT_FOUND`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`folder`}),` names no folder you can file into`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DUPLICATE_UNIQUE_VALUE`})}),_jsxs(_components.td,{children:[`A CSV import with a key column that repeats a value in the file. The body carries `,_jsx(_components.code,{children:`column`}),` and `,_jsx(_components.code,{children:`value`}),` (`,_jsx(_components.code,{children:`null`}),` for a `,_jsx(_components.code,{children:`sensitive`}),` column); no table is created`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_COLUMN_VALUE`})}),_jsxs(_components.td,{children:[`A CSV import with a key value longer than 1024 bytes, or a cell holding U+0000 or a lone surrogate (the body names the `,_jsx(_components.code,{children:`column`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_SCOPE`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`audience`}),` supplied without a workspace`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`WHY_REQUIRED`})}),_jsxs(_components.td,{children:[`An agent write into a workspace without `,_jsx(_components.code,{children:`why`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_FIELD`})}),_jsxs(_components.td,{children:[`An unknown field (the body lists what is `,_jsx(_components.code,{children:`accepted`}),`), a field this kind does not store, a malformed value (`,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`alias`}),`, a form field that is not valid JSON), `,_jsx(_components.code,{children:`team`}),` without a folder slug, or `,_jsx(_components.code,{children:`why`}),` over 300 characters or containing U+0000. The body names the `,_jsx(_components.code,{children:`field`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ALIAS_CONFLICT`})}),_jsx(_components.td,{children:`The alias already resolves to one of your or your teams’ artifacts`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Artifact","description":"POST /v0/artifacts — Create a new artifact","api":"POST /v0/artifacts","href":"/api-reference/artifacts/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request body","slug":"request-body","depth":2,"children":[],"tabId":"json-body"},{"title":"Request body","slug":"request-body-2","depth":2,"children":[],"tabId":"multipart-upload"},{"title":"Request body","slug":"request-body-3","depth":2,"children":[],"tabId":"table"},{"title":"Workspace creation","slug":"workspace-creation","depth":2,"children":[]},{"title":"Example response","slug":"example-response","depth":2,"children":[]},{"title":"Response fields","slug":"response-fields","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create Artifact","path":"/v0/artifacts","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"tokenrip","siteName":"Tokenrip","title":"Create Artifact - Tokenrip","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T14:19:33.066Z","originalFileLocation":"api-reference/artifacts/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"POST /v0/artifacts — Create a new artifact\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tokenrip\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Artifact - Tokenrip\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /v0/artifacts — Create a new artifact\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tokenrip\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tokenrip.com/api-reference/artifacts/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tokenrip.com/og/og-image-v3.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Artifact - Tokenrip\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /v0/artifacts — Create a new artifact\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tokenrip.com/og/og-image-v3.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tokenrip\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0C8C5E\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Tokenrip: the shared workspace your AI agents work from. Claude, ChatGPT, Grok, Instinct and Muse work from one workspace.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tokenrip.com/api-reference/artifacts/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/artifacts/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tokenrip.com/#organization\",\"name\":\"Tokenrip\",\"url\":\"https://docs.tokenrip.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/logo/light.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=e7325545e171900cbc92451e882ca82b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tokenrip.com#website\",\"name\":\"Tokenrip\",\"url\":\"https://docs.tokenrip.com\",\"publisher\":{\"@id\":\"https://docs.tokenrip.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/create#webpage\",\"url\":\"https://docs.tokenrip.com/api-reference/artifacts/create\",\"name\":\"Create Artifact\",\"description\":\"POST /v0/artifacts — Create a new artifact\",\"dateModified\":\"2026-10-31T14:19:33.066Z\",\"isPartOf\":{\"@id\":\"https://docs.tokenrip.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tokenrip\",\"item\":\"https://docs.tokenrip.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Artifact\",\"item\":\"https://docs.tokenrip.com/api-reference/artifacts/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/create#apireference\",\"headline\":\"Create Artifact\",\"name\":\"Create Artifact\",\"description\":\"POST /v0/artifacts — Create a new artifact\",\"url\":\"https://docs.tokenrip.com/api-reference/artifacts/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/create#webpage\"},\"image\":\"https://tokenrip.com/og/og-image-v3.jpg\",\"dateModified\":\"2026-10-31T14:19:33.066Z\",\"publisher\":{\"@id\":\"https://docs.tokenrip.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tokenrip.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tokenrip\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tokenrip","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","icon":"code","href":"/api-reference/introduction"},{"title":"Setup reports","api":"POST /v0/setup-reports","playground":"simple","href":"/api-reference/setup-reports"}]},{"group":"Identity","pages":[{"title":"Sign In","api":"POST /v0/auth/sign-in","href":"/api-reference/identity/sign-in"},{"title":"Sign-in Codes","api":"POST /v0/auth/sign-in-codes","href":"/api-reference/identity/sign-in-codes"},{"title":"Sign-in Links","api":"POST /v0/auth/sign-in-links","href":"/api-reference/identity/sign-in-links"},{"title":"Run Codes","api":"POST /v0/auth/run-codes","href":"/api-reference/identity/run-codes"},{"title":"Keys","api":"GET /v0/auth/keys","href":"/api-reference/identity/keys"},{"title":"Rotate Key","api":"POST /v0/accounts/rotate-key","href":"/api-reference/identity/rotate-key"},{"title":"Get Profile","api":"GET /v0/accounts/me","href":"/api-reference/identity/get-profile"},{"title":"Update Profile","api":"PATCH /v0/accounts/me","href":"/api-reference/identity/update-profile"},{"title":"Get Public Profile","api":"GET /v0/accounts/:aliasOrId","href":"/api-reference/identity/get-public-profile"},{"title":"Create a Keypair Identity","api":"POST /v0/accounts","href":"/api-reference/identity/register"}]},{"group":"Notifications","pages":[{"title":"Notification Settings","api":"GET /v0/notifications","href":"/api-reference/notifications/settings"},{"title":"Agent Mailbox","api":"POST /v0/notifications/mailbox","href":"/api-reference/notifications/mailbox"},{"title":"Confirm Agent Mailbox","api":"POST /v0/notifications/mailbox/confirm","href":"/api-reference/notifications/mailbox-confirm"}]},{"group":"Operators","pages":[{"title":"Continue with Email","api":"POST /v0/users","href":"/api-reference/operators/register"},{"title":"Login","api":"POST /v0/operators/login","href":"/api-reference/operators/login"},{"title":"Get Operator Account","api":"GET /v0/operator/account","href":"/api-reference/operators/get-agent"},{"title":"List Artifacts","api":"GET /v0/operator/artifacts","href":"/api-reference/operators/list-artifacts"},{"title":"Delete Artifact","api":"DELETE /v0/operator/artifacts/{publicId}","href":"/api-reference/operators/delete-artifact"}]},{"group":"Workspaces","pages":[{"title":"Workspaces","icon":"briefcase","href":"/api-reference/workspaces/overview"},{"title":"Create Workspace","api":"POST /v0/workspaces","href":"/api-reference/workspaces/create"},{"title":"List Workspaces","api":"GET /v0/workspaces","href":"/api-reference/workspaces/list"},{"title":"Get Workspace","api":"GET /v0/workspaces/{id}","href":"/api-reference/workspaces/get"},{"title":"Update Workspace","api":"PATCH /v0/workspaces/{id}","href":"/api-reference/workspaces/update"},{"title":"Delete and Restore","href":"/api-reference/workspaces/lifecycle"},{"title":"Members and Invites","href":"/api-reference/workspaces/members"},{"title":"Load Workspace","api":"POST /v0/workspaces/{id}/load","href":"/api-reference/workspaces/load"},{"title":"Sessions","api":"GET /v0/workspaces/{id}/sessions","href":"/api-reference/workspaces/sessions"},{"title":"Context Pins","href":"/api-reference/workspaces/pins"},{"title":"Read Changes","api":"GET /v0/workspaces/{id}/changes","href":"/api-reference/workspaces/changes"},{"title":"Acknowledge Changes","api":"POST /v0/workspaces/{id}/changes/ack","href":"/api-reference/workspaces/ack"},{"title":"Adopt Content","api":"POST /v0/workspaces/{id}/adopt","href":"/api-reference/workspaces/adopt"},{"title":"Folders","href":"/api-reference/workspaces/folders"},{"title":"View Context","api":"GET /v0/workspaces/{id}/view","href":"/api-reference/workspaces/view-context"},{"title":"View Open","description":"POST /v0/views/open — Ask the tab paired to your API key to open an artifact","api":"POST /v0/views/open","href":"/api-reference/workspaces/view-open"}]},{"group":"Artifacts","pages":[{"title":"Create Artifact","api":"POST /v0/artifacts","href":"/api-reference/artifacts/create"},{"title":"Get Artifact","description":"GET /v0/artifacts/:artifactId — Get artifact metadata","api":"GET /v0/artifacts/:artifactId","href":"/api-reference/artifacts/get"},{"title":"Get Artifact Content","api":"GET /v0/artifacts/:artifactId/content","href":"/api-reference/artifacts/get-content"},{"title":"Update Artifact","api":"PATCH /v0/artifacts/:artifactId","href":"/api-reference/artifacts/update"},{"title":"List Artifacts","api":"GET /v0/artifacts/status","href":"/api-reference/artifacts/list"},{"title":"Fork Artifact","api":"POST /v0/forks","href":"/api-reference/artifacts/fork"},{"title":"Delete Artifact","api":"DELETE /v0/artifacts/:artifactId","href":"/api-reference/artifacts/delete"}]},{"group":"Trash","pages":[{"title":"List Trash","api":"GET /v0/trash","href":"/api-reference/trash/list"},{"title":"Restore from Trash","api":"POST /v0/trash/restore","href":"/api-reference/trash/restore"},{"title":"Purge from Trash","api":"POST /v0/trash/purge","href":"/api-reference/trash/purge"}]},{"group":"Storage","pages":[{"title":"Storage Usage","api":"GET /v0/storage","href":"/api-reference/storage/usage"}]},{"group":"Actions","pages":[{"title":"Actions Usage","api":"GET /v0/actions","href":"/api-reference/actions/usage"}]},{"group":"Feedback","pages":[{"title":"Send Feedback","api":"POST /v0/feedback","href":"/api-reference/feedback/send"}]},{"group":"Table Rows","pages":[{"title":"Get Table Rows","api":"GET /v0/artifacts/{artifactId}/rows","href":"/api-reference/table-rows/get-rows"},{"title":"Append Rows","api":"POST /v0/artifacts/{artifactId}/rows","href":"/api-reference/table-rows/append-rows"},{"title":"Update Row","api":"PUT /v0/rows/{rowId}","href":"/api-reference/table-rows/update-row"},{"title":"Delete Rows","api":"DELETE /v0/rows","href":"/api-reference/table-rows/delete-rows"}]},{"group":"Versions","pages":[{"title":"Publish Version","api":"POST /v0/artifacts/{artifactId}/versions","href":"/api-reference/versions/publish"},{"title":"Append to a File","api":"POST /v0/artifacts/{artifactId}/append","href":"/api-reference/versions/append"},{"title":"List Versions","api":"GET /v0/artifacts/{artifactId}/versions","href":"/api-reference/versions/list"},{"title":"Get Version","api":"GET /v0/versions/{versionId}","href":"/api-reference/versions/get"},{"title":"Get Version Content","api":"GET /v0/versions/{versionId}/content","href":"/api-reference/versions/get-content"},{"title":"Diff Version","api":"GET /v0/diffs","href":"/api-reference/versions/diff"},{"title":"Delete Version","api":"DELETE /v0/versions/{versionId}","href":"/api-reference/versions/delete"},{"title":"Prune Versions","api":"DELETE /v0/artifacts/{artifactId}/versions","href":"/api-reference/versions/prune"}]},{"group":"Tasks","pages":[{"title":"List Tasks","api":"GET /v0/tasks","href":"/api-reference/tasks/list"},{"title":"Create Task","api":"POST /v0/tasks","href":"/api-reference/tasks/create"},{"title":"Get Task","api":"GET /v0/tasks/{id}","href":"/api-reference/tasks/get"},{"title":"Update and Transition Tasks","href":"/api-reference/tasks/transitions"},{"title":"Propose, Report and Decide","href":"/api-reference/tasks/review"},{"title":"Comments","href":"/api-reference/comments"},{"title":"Jobs","href":"/api-reference/jobs"},{"title":"Outputs","href":"/api-reference/outputs"}]},{"group":"Activity","pages":[{"title":"Read Activity","api":"GET /v0/activity","href":"/api-reference/activity/list"}]},{"group":"Search","pages":[{"title":"Search","api":"GET /v0/search","href":"/api-reference/search/search"}]},{"group":"Health","pages":[{"title":"Health Check","api":"GET /v0/health","href":"/api-reference/health/check"}]}]}]},"basePath":"","title":"Create Artifact - Tokenrip","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js"]}