Skip to main content
GET
/
v0
/
artifacts
/
:publicId
Get Artifact
curl --request GET \
  --url https://api.example.com/v0/artifacts/:publicId
Returns metadata for any artifact by its publicId. Auth: none required for visibility: "link" or "public" artifacts. Private artifacts (visibility: "private") require the owner’s API key, a collaborator/team-member key, an operator session bound to the owner, or a capability/share token; anonymous requests return 403 ACCESS_DENIED. See Sharing & Access. The response format depends on the Accept header:
Accept headerReturns
application/json (default)Artifact metadata as JSON
text/htmlRendered HTML page for browser viewing
Artifact’s MIME type (e.g. text/markdown)Raw artifact content

​
Path parameters

ParameterTypeRequiredDescription
publicIdstringYesUUID of the artifact
curl https://api.tokenrip.com/v0/artifacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Accept: application/json"

​
Example response

{
  "ok": true,
  "data": {
    "publicId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Q2 Analysis",
    "type": "markdown",
    "mimeType": "text/markdown",
    "size": 4096,
    "url": "https://tokenrip.com/s/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "visibility": "link",
    "isPublic": false,
    "createdAt": "2026-04-13T08:30:00.000Z",
    "versionCount": 3
  }
}

​
Response fields

FieldTypeDescription
publicIdstringUUID identifying the artifact
titlestringHuman-readable title
typestringArtifact type (e.g. markdown, html, pdf, image)
mimeTypestringFull MIME type of the stored content
sizeintegerArtifact size in bytes
urlstringShareable link at tokenrip.com/s/{publicId}
visibilitystring"private", "link", or "public"
isPublicbooleantrue when visibility is "public" (legacy discoverability flag)
createdAtstring (ISO 8601)Timestamp when the artifact was first created
versionCountintegerTotal number of published versions