curl --request POST \
--url 'https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"file_id": "pf_SdhEA5fbZJGnHzwrNJMMSB",
"title": "Checkout API latency postmortem"
}
'import requests
url = "https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key="
payload = {
"file_id": "pf_SdhEA5fbZJGnHzwrNJMMSB",
"title": "Checkout API latency postmortem"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({file_id: 'pf_SdhEA5fbZJGnHzwrNJMMSB', title: 'Checkout API latency postmortem'})
};
fetch('https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'file_id' => 'pf_SdhEA5fbZJGnHzwrNJMMSB',
'title' => 'Checkout API latency postmortem'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key="
payload := strings.NewReader("{\n \"file_id\": \"pf_SdhEA5fbZJGnHzwrNJMMSB\",\n \"title\": \"Checkout API latency postmortem\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"file_id\": \"pf_SdhEA5fbZJGnHzwrNJMMSB\",\n \"title\": \"Checkout API latency postmortem\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"file_id\": \"pf_SdhEA5fbZJGnHzwrNJMMSB\",\n \"title\": \"Checkout API latency postmortem\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"artifact_id": "art_VnfrWic8UbB9q3EfYR4Gmg",
"title": "Checkout API latency postmortem",
"gallery_path": "/ai-sre/artifacts/art_VnfrWic8UbB9q3EfYR4Gmg"
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "AccessDenied",
"message": "Access Denied."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Publish file as artifact
Publish a session-produced file to the artifact gallery.
curl --request POST \
--url 'https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"file_id": "pf_SdhEA5fbZJGnHzwrNJMMSB",
"title": "Checkout API latency postmortem"
}
'import requests
url = "https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key="
payload = {
"file_id": "pf_SdhEA5fbZJGnHzwrNJMMSB",
"title": "Checkout API latency postmortem"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({file_id: 'pf_SdhEA5fbZJGnHzwrNJMMSB', title: 'Checkout API latency postmortem'})
};
fetch('https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'file_id' => 'pf_SdhEA5fbZJGnHzwrNJMMSB',
'title' => 'Checkout API latency postmortem'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key="
payload := strings.NewReader("{\n \"file_id\": \"pf_SdhEA5fbZJGnHzwrNJMMSB\",\n \"title\": \"Checkout API latency postmortem\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"file_id\": \"pf_SdhEA5fbZJGnHzwrNJMMSB\",\n \"title\": \"Checkout API latency postmortem\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/artifact/gallery/publish-from-file?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"file_id\": \"pf_SdhEA5fbZJGnHzwrNJMMSB\",\n \"title\": \"Checkout API latency postmortem\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"artifact_id": "art_VnfrWic8UbB9q3EfYR4Gmg",
"title": "Checkout API latency postmortem",
"gallery_path": "/ai-sre/artifacts/art_VnfrWic8UbB9q3EfYR4Gmg"
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "AccessDenied",
"message": "Access Denied."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 300 requests/minute; 20 requests/second per account |
| Permissions | None — any valid app_key can call this operation |
Usage
- Any account member who can see the file may publish it. Republishing a file whose path already has a live artifact replaces that artifact and requires
can_editon it. - Allowed file types: HTML/Markdown, images, PDF, text/data/code files, and zip/tar archives, matched by extension. Other types, files over 16 MiB, and files no longer retrievable (runner offline or file expired) fail with
InvalidParameter. - Publishing is an upsert keyed by the source session and workspace path: republishing replaces the title and bytes under a fresh
file_idand keeps theartifact_id, which makes an existing public snapshot stale until synced. Republishing a removed artifact restores it with the sameartifact_id, with sharing off. - A new artifact takes its creator and personal/team scope from the source session (its owner and team); move it afterwards with
/safari/artifact/gallery/updateif needed. - Every call is recorded in the account audit log.
Authorizations
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
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.
Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.
"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
Error payload inside the response envelope. Present only on non-2xx responses.
Show child attributes
Show child attributes
Result of publishing a file to the gallery.
Show child attributes
Show child attributes
Was this page helpful?