Skip to main content
POST
Publish file as artifact

Restrictions

Usage

  • Allowed file types: HTML/Markdown, images, PDF, text/data/code files, and zip/tar archives, matched by extension. Files over 16 MiB are rejected.
  • Publishing is an upsert keyed by the source session and workspace path — republishing the same file replaces the artifact’s bytes under a fresh file_id, which makes an existing public snapshot stale until synced.
  • The artifact inherits personal/team scope from the source session; move it afterwards with /safari/artifact/gallery/update if needed.
  • Every call is recorded in the account audit log.

Authorizations

app_key
string
query
required

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Publish a session-produced file to the artifact gallery.

file_id
string
required

Presented-file ID (pf_ prefix) of a file produced in a session, as shown on the file card in chat.

title
string
required

Gallery display title. Trimmed; must be non-empty.

Response

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

Result of publishing a file to the gallery.