Skip to main content
POST
Enable public sharing

Restrictions

Usage

  • The public link is anonymous: anyone with it can view the content, and the link may be forwarded. The content is copied to public CDN objects, so viewing the link does not go through this API.
  • Requires can_edit on the artifact (the creator, any member of its owning team, or anyone who can manage its source session); otherwise the call fails with AccessDenied.
  • Idempotent: enabling an already-shared artifact returns the existing state unchanged, and re-enabling after a revoke brings the same link back, because the link is keyed by artifact ID.
  • Artifacts over 16 MiB cannot be shared; the call fails with InvalidParameter. On deployments where public sharing is not configured, the call fails with InternalError.
  • Sharing is a snapshot: later republishes do not update the public content until you call /safari/artifact/gallery/share/sync.
  • Every call is recorded in the account audit log.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Identify one gallery artifact.

artifact_id
string
required

Artifact ID (art_ prefix). Also the key of the public-share link.

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

Public-share state of an artifact.