SHshareout
Artifacts

Get an artifact

Changed on

The path also accepts the artifact's slug. Any signed-in caller who can view the artifact gets its details; can_edit, can_delete and can_manage_comments say which writes the API will accept from this caller.

get/v1/artifacts/{id}

Request

  • Base URL
    https://shareout.site
  • URL
    https://shareout.site/v1/artifacts/{id}
  • Auth
    HTTP bearer

Response

The artifact

idstring
namestring
slugstring
visibility'public' | 'workspace' | 'private'

'unlisted' was retired 2026-07 — still accepted as input and treated as 'public'.

moderation_status'approved' | 'pending' | 'blocked'

Safety review state for open visibility.

allow_anon_writeboolean
allow_anon_emailboolean
allow_anon_agentboolean
allow_anon_collabboolean
urlstring uri
thumbnail_urlstring uri nullable
workspace_idstring nullable
artifact_typestring
pausedboolean
current_versioninteger

version_no live on the production deployment (reflects rollback).

live_messagestring nullable

Change note of the live version (detail endpoint only).

live_message_source'author' | 'ai' | 'null' nullable

author when the publisher wrote live_message, ai when it was generated (detail endpoint only).

user_rolestring

Caller's role (list endpoint only).

can_editboolean

Caller may update the artifact and use the editor (detail endpoint only).

can_deleteboolean

Caller may move the artifact to Trash (detail endpoint only).

can_manage_commentsboolean

Caller may change the artifact's comment settings, such as guest comments (owner; detail endpoint only).

pagesstring[]

HTML pages of the live version, entrypoint first (detail endpoint only; present when there are 2+).

entrypointstring

The live version's entrypoint (detail endpoint only; present with pages).

is_favoriteboolean
created_atstring date-time
updated_atstring date-time nullable

Changes

  • 10f3cba6ec07Revision changes
    • info

      added the optional property to the response with the status

  • 46103f506fcaRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status