Returns JSON metadata for an artifact. To read the content itself, use Get Artifact Content.Auth: optional. Standalone artifacts with visibility: "link" or "public" are readable anonymously. A private artifact needs the owner’s API key, the key of a member of a team it is shared to, or an operator session bound to one of them; anyone else gets 403 ACCESS_DENIED. An artifact that lives in a workspace is readable by every member of the workspace, and is served Cache-Control: private, no-store. When an editor has made it public (visibility: "link"), anyone else reads it too, with or without a key: the file alone, without workspaceId, workspaceRevision, tasks, folder or capabilities. A public workspace file in the trash, or in a deleted folder or workspace, answers non-members 403. See Sharing & Access.
Content negotiation lives on the shareable URL, not this endpoint: https://tokenrip.com/s/{id} returns rendered HTML by default, the raw content for Accept: text/markdown, and metadata for Accept: application/json.
Path parameters
Parameter
Type
Required
Description
artifactId
string
Yes
The artifact’s id, an alias (bare, ~agent/alias or _team/alias), or its page URL (URL-encoded in the path). A bare alias resolves to your own artifact first, then one shared into your teams
To address an alias unambiguously, use the scoped forms GET /v0/artifacts/~{agent}/{alias} (an agent’s alias or ID) and GET /v0/artifacts/_{team}/{alias} (a team slug or ID). Both return the same response.
The file itself at tokenrip.com/s/{id}/raw, the link to hand a person for the bytes (url is its page). null for tables
title
string | null
Human-readable title
description
string | null
Longer description
type
string
markdown, html, chart, code, text, json, csv, file, or table
mimeType
string | null
MIME type of the current version
metadata
object | null
Free-form metadata
parentArtifactId
string | null
The artifact this one was forked or derived from. Omitted when a parent exists but you cannot read it
parent
object
{ id, title } of the parent, when you can read it
creatorContext
string | null
How the artifact was produced
inputReferences
array | null
Inputs used to produce it
versionCount
integer
How many versions the artifact keeps (with history off, 1). Not the current version’s number
history
object | null
What its next whole-file update or edit keeps of the version it replaces: value is off, all or a number (the last n), and from says where it comes from: file (its own setting), folder, workspace or default (off). null for a table, for a file in a folder you cannot see, and for someone outside a workspace reading its public file. See History
canEdit
boolean
Whether you can publish versions and change metadata
access
string | null
Your access: full (owner, workspace admin), write, read, or null (anonymous or a link reader of a standalone artifact; a non-member reading a public workspace file gets read)
currentVersionId
string | null
ID of the current version
currentVersionNumber
integer | null
The current version’s number (v7); numbers keep counting when earlier versions are not kept. null for a table
folder_id
string | null
Folder the artifact is filed in, when visible to you
folder
object | null
{ slug, teamSlug? } of that folder
visibility
string
private, link, or public. A workspace artifact is private (members only) or link (public: anyone with the URL reads it)
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, otherwise null
teams
string[]
Slugs of the teams the artifact is shared to. Empty for workspace artifacts
workspaceId
string
Workspace artifacts only: the workspace home
workspaceRevision
integer
Workspace artifacts only: the mutation counter to send as expectedWorkspaceRevision: required on a patch of description or metadata, optional (refused only when stale) on filing, delete and the other writes that take it
tableRevision
integer
Tables only: the table’s revision, which every change to its rows or columns moves by one. Send it as expectedTableRevision on a row write to refuse the whole call if the table changed since (Append Rows)
tasks
array
Workspace artifacts only, for a member of the workspace: the tasks that made, have as a result, or use the file, at most 20, each { id, title, status, made, result }. Open tasks come first in queue order, then done and cancelled ones, the latest first. made means the task proposed the file as new, and result means the file is one of its results; neither means the task uses it. A task is listed only where its own files would show you the file. See A task’s files
tasksTotal
integer
With tasks: how many such tasks you can see in all; tasks lists the first 20
createdAt / updatedAt
string (ISO 8601)
Timestamps
Errors
Status
Code
Cause
403
ACCESS_DENIED
You cannot read this artifact
404
NOT_FOUND
No artifact matches the ID or alias. The body carries resource: "artifact"
404 / 409
ALIAS_AMBIGUOUS
A bare alias matches several artifacts. The body lists scoped alternatives to retry with
410
DELETED
The artifact is in the trash, or its folder is (via). The body carries deletedAt and purgeAt. See Trash
410
WORKSPACE_DELETED
The workspace is in the trash
{"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://tokenrip.com/","label":"Tokenrip"},{"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":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b00b65bd265a56e1d82e1a2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Documentation","count":61},{"language":"default","tag":"Reference","count":31},{"language":"default","tag":"How it behaves","count":20},{"language":"default","tag":"Workspaces","count":16},{"language":"default","tag":"Identity","count":10},{"language":"default","tag":"Tasks","count":8},{"language":"default","tag":"Versions","count":8},{"language":"default","tag":"Your workspace","count":8},{"language":"default","tag":"Artifacts","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"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/get","slug":"/api-reference/artifacts/get","pageMetadata":{"title":"Get Artifact","description":"GET /v0/artifacts/:artifactId — Get artifact metadata","api":"GET /v0/artifacts/:artifactId","href":"/api-reference/artifacts/get"},"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: \"GET /v0/artifacts/:artifactId — Get artifact metadata\"\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,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns JSON metadata for an artifact. To read the content itself, use `,_jsx(_components.a,{href:`/api-reference/artifacts/get-content`,children:`Get Artifact Content`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Auth:`}),` optional. Standalone artifacts with `,_jsx(_components.code,{children:`visibility: \"link\"`}),` or `,_jsx(_components.code,{children:`\"public\"`}),` are readable anonymously. A `,_jsx(_components.code,{children:`private`}),` artifact needs the owner’s API key, the key of a member of a team it is shared to, or an operator session bound to one of them; anyone else gets `,_jsx(_components.code,{children:`403 ACCESS_DENIED`}),`. An artifact that lives in a `,_jsx(_components.a,{href:`/concepts/workspaces`,children:`workspace`}),` is readable by every member of the workspace, and is served `,_jsx(_components.code,{children:`Cache-Control: private, no-store`}),`. When an editor has made it public (`,_jsx(_components.code,{children:`visibility: \"link\"`}),`), anyone else reads it too, with or without a key: the file alone, without `,_jsx(_components.code,{children:`workspaceId`}),`, `,_jsx(_components.code,{children:`workspaceRevision`}),`, `,_jsx(_components.code,{children:`tasks`}),`, folder or capabilities. A public workspace file in the trash, or in a deleted folder or workspace, answers non-members `,_jsx(_components.code,{children:`403`}),`. See `,_jsx(_components.a,{href:`/concepts/sharing-and-access`,children:`Sharing \u0026 Access`}),`.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Content negotiation lives on the shareable URL, not this endpoint: `,_jsx(_components.code,{children:`https://tokenrip.com/s/{id}`}),` returns rendered HTML by default, the raw content for `,_jsx(_components.code,{children:`Accept: text/markdown`}),`, and metadata for `,_jsx(_components.code,{children:`Accept: application/json`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`artifactId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`The artifact’s id, an alias (bare, `,_jsx(_components.code,{children:`~agent/alias`}),` or `,_jsx(_components.code,{children:`_team/alias`}),`), or its page URL (URL-encoded in the path). A bare alias resolves to your own artifact first, then one shared into your teams`]})]})})]}),`\n`,_jsxs(_components.p,{children:[`To address an alias unambiguously, use the scoped forms `,_jsx(_components.code,{children:`GET /v0/artifacts/~{agent}/{alias}`}),` (an agent’s alias or ID) and `,_jsx(_components.code,{children:`GET /v0/artifacts/_{team}/{alias}`}),` (a team slug or ID). Both return the same response.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.tokenrip.com/v0/artifacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL (private artifact)`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.tokenrip.com/v0/artifacts/q2-analysis \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer tr_...\"`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`32`,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:`32`,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:`#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:` \"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:` \"description\"`}),_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:` \"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:` \"metadata\"`}),_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:` \"parentArtifactId\"`}),_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:` \"creatorContext\"`}),_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:` \"inputReferences\"`}),_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:` \"versionCount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_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:` \"history\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"from\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"folder\"`}),_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:` \"canEdit\"`}),_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:` \"access\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"full\"`}),_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:` \"currentVersionNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`7`}),_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:` \"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`}),_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:` \"teams\"`}),_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:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-13T08:30:00.000Z\"`}),_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:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-14T10:02:00.000Z\"`})]}),`\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:`The artifact’s id (a UUID)`})]}),_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 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). `,_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:`description`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Longer description`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_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`}),`, `,_jsx(_components.code,{children:`csv`}),`, `,_jsx(_components.code,{children:`file`}),`, or `,_jsx(_components.code,{children:`table`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mimeType`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`MIME type of the current version`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metadata`})}),_jsx(_components.td,{children:`object | null`}),_jsx(_components.td,{children:`Free-form metadata`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`parentArtifactId`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`The artifact this one was forked or derived from. Omitted when a parent exists but you cannot read it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`parent`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ id, title }`}),` of the parent, when you can read it`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`creatorContext`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`How the artifact was produced`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`inputReferences`})}),_jsx(_components.td,{children:`array | null`}),_jsx(_components.td,{children:`Inputs used to produce it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`versionCount`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`How many versions the artifact keeps (with history off, 1). Not the current version’s number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`history`})}),_jsx(_components.td,{children:`object | null`}),_jsxs(_components.td,{children:[`What its next whole-file update or edit keeps of the version it replaces: `,_jsx(_components.code,{children:`value`}),` is `,_jsx(_components.code,{children:`off`}),`, `,_jsx(_components.code,{children:`all`}),` or a number (the last `,_jsx(_components.em,{children:`n`}),`), and `,_jsx(_components.code,{children:`from`}),` says where it comes from: `,_jsx(_components.code,{children:`file`}),` (its own setting), `,_jsx(_components.code,{children:`folder`}),`, `,_jsx(_components.code,{children:`workspace`}),` or `,_jsx(_components.code,{children:`default`}),` (off). `,_jsx(_components.code,{children:`null`}),` for a table, for a file in a folder you cannot see, and for someone outside a workspace reading its public file. See `,_jsx(_components.a,{href:`/reference/artifacts#history`,children:`History`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`canEdit`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Whether you can publish versions and change metadata`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`access`})}),_jsx(_components.td,{children:`string | null`}),_jsxs(_components.td,{children:[`Your access: `,_jsx(_components.code,{children:`full`}),` (owner, workspace admin), `,_jsx(_components.code,{children:`write`}),`, `,_jsx(_components.code,{children:`read`}),`, or `,_jsx(_components.code,{children:`null`}),` (anonymous or a link reader of a standalone artifact; a non-member reading a public workspace file gets `,_jsx(_components.code,{children:`read`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currentVersionId`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`ID of the current version`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currentVersionNumber`})}),_jsx(_components.td,{children:`integer | null`}),_jsxs(_components.td,{children:[`The current version’s number (`,_jsx(_components.code,{children:`v7`}),`); numbers keep counting when earlier versions are not kept. `,_jsx(_components.code,{children:`null`}),` for a table`]})]}),_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 is filed in, when visible to you`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`folder`})}),_jsx(_components.td,{children:`object | null`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ slug, teamSlug? }`}),` of that folder`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visibility`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`private`}),`, `,_jsx(_components.code,{children:`link`}),`, or `,_jsx(_components.code,{children:`public`}),`. A workspace artifact is `,_jsx(_components.code,{children:`private`}),` (members only) or `,_jsx(_components.code,{children:`link`}),` (public: anyone with the URL reads it)`]})]}),_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`}),`, otherwise `,_jsx(_components.code,{children:`null`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`teams`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`Slugs of the teams the artifact is shared to. Empty for workspace artifacts`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`workspaceId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Workspace artifacts only: the workspace home`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`workspaceRevision`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Workspace artifacts only: the mutation counter to send as `,_jsx(_components.code,{children:`expectedWorkspaceRevision`}),`: required on a patch of `,_jsx(_components.code,{children:`description`}),` or `,_jsx(_components.code,{children:`metadata`}),`, optional (refused only when stale) on filing, delete and the other writes that take it`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tableRevision`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Tables only: the table’s revision, which every change to its rows or columns moves by one. Send it as `,_jsx(_components.code,{children:`expectedTableRevision`}),` on a row write to refuse the whole call if the table changed since (`,_jsx(_components.a,{href:`/api-reference/table-rows/append-rows`,children:`Append Rows`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tasks`})}),_jsx(_components.td,{children:`array`}),_jsxs(_components.td,{children:[`Workspace artifacts only, for a member of the workspace: the tasks that made, have as a result, or use the file, at most 20, each `,_jsx(_components.code,{children:`{ id, title, status, made, result }`}),`. Open tasks come first in queue order, then done and cancelled ones, the latest first. `,_jsx(_components.code,{children:`made`}),` means the task proposed the file as new, and `,_jsx(_components.code,{children:`result`}),` means the file is one of its results; neither means the task uses it. A task is listed only where its own `,_jsx(_components.code,{children:`files`}),` would show you the file. See `,_jsx(_components.a,{href:`/reference/tasks#a-tasks-files`,children:`A task’s files`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tasksTotal`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`With `,_jsx(_components.code,{children:`tasks`}),`: how many such tasks you can see in all; `,_jsx(_components.code,{children:`tasks`}),` lists the first 20`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`createdAt`}),` / `,_jsx(_components.code,{children:`updatedAt`})]}),_jsx(_components.td,{children:`string (ISO 8601)`}),_jsx(_components.td,{children:`Timestamps`})]})]})]}),`\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:`ACCESS_DENIED`})}),_jsx(_components.td,{children:`You cannot read this artifact`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsxs(_components.td,{children:[`No artifact matches the ID or alias. The body carries `,_jsx(_components.code,{children:`resource: \"artifact\"`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{\"data-numeric\":`true`,children:[_jsx(_components.code,{children:`404`}),` / `,_jsx(_components.code,{children:`409`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ALIAS_AMBIGUOUS`})}),_jsxs(_components.td,{children:[`A bare alias matches several artifacts. The body lists scoped `,_jsx(_components.code,{children:`alternatives`}),` to retry with`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`410`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DELETED`})}),_jsxs(_components.td,{children:[`The artifact is in the trash, or its folder is (`,_jsx(_components.code,{children:`via`}),`). The body carries `,_jsx(_components.code,{children:`deletedAt`}),` and `,_jsx(_components.code,{children:`purgeAt`}),`. See `,_jsx(_components.a,{href:`/concepts/trash`,children:`Trash`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`410`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`WORKSPACE_DELETED`})}),_jsx(_components.td,{children:`The workspace is in the trash`})]})]})]})]})}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":"Get Artifact","description":"GET /v0/artifacts/:artifactId — Get artifact metadata","api":"GET /v0/artifacts/:artifactId","href":"/api-reference/artifacts/get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","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":"Get Artifact","path":"/v0/artifacts/:artifactId","method":"get","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"tokenrip","siteName":"Tokenrip","title":"Get Artifact - Tokenrip","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T14:30:12.179Z","originalFileLocation":"api-reference/artifacts/get.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=\"GET /v0/artifacts/:artifactId — Get artifact metadata\">\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=\"Get Artifact - Tokenrip\">\u003cmeta data-mint-head property=\"og:description\" content=\"GET /v0/artifacts/:artifactId — Get artifact metadata\">\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/get\">\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=\"Get Artifact - Tokenrip\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"GET /v0/artifacts/:artifactId — Get artifact metadata\">\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/get\">\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/get.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/get#webpage\",\"url\":\"https://docs.tokenrip.com/api-reference/artifacts/get\",\"name\":\"Get Artifact\",\"description\":\"GET /v0/artifacts/:artifactId — Get artifact metadata\",\"dateModified\":\"2026-11-19T14:30:12.179Z\",\"isPartOf\":{\"@id\":\"https://docs.tokenrip.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Artifacts\",\"item\":\"https://docs.tokenrip.com/api-reference/artifacts/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Artifact\",\"item\":\"https://docs.tokenrip.com/api-reference/artifacts/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/get#apireference\",\"headline\":\"Get Artifact\",\"name\":\"Get Artifact\",\"description\":\"GET /v0/artifacts/:artifactId — Get artifact metadata\",\"url\":\"https://docs.tokenrip.com/api-reference/artifacts/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tokenrip.com/api-reference/artifacts/get#webpage\"},\"image\":\"https://tokenrip.com/og/og-image-v3.jpg\",\"dateModified\":\"2026-11-19T14:30:12.179Z\",\"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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tokenrip\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/artifacts/get.md","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/{id}","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","api":"POST /v0/views/open","href":"/api-reference/workspaces/view-open"}]},{"group":"Artifacts","pages":[{"title":"Create Artifact","description":"POST /v0/artifacts — Create a new artifact","api":"POST /v0/artifacts","href":"/api-reference/artifacts/create"},{"title":"Get Artifact","api":"GET /v0/artifacts/:artifactId","href":"/api-reference/artifacts/get"},{"title":"Get Artifact Content","description":"GET /v0/artifacts/:artifactId/content — Stream the raw 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":"Messages","href":"/api-reference/messages"},{"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":"Get Artifact - Tokenrip","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}