Save an artifact or a folder as a template

POST

/v1/artifact-templates

curl --request POST \
  --url https://shareout.site/v1/artifact-templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "artifact_id": "example", "folder_id": "example", "name": "example", "description": "example", "tags": [ "example" ], "scope": "private", "shared_workspace_ids": [ "example" ], "version": "1.0.0", "notes": "example", "readme": "example", "include_sample_rows": false, "preview_image": "example", "acknowledge_findings": true }'

• Production

Snapshots the live version’s files, folder tree, table/dataset schemas and connector names (never data, credentials, comments, Knowledge or analytics). Credentials found in the code are redacted. If the content looks personal or workspace-specific the call answers 409 REVIEW_REQUIRED with findings; repeat with acknowledge_findings: true. scope: instance is for instance admins only.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

artifact_id

string

folder_id

string

name

string

description

string

tags

Array<string>

scope

string

default: private

Allowed values: private shared instance

shared_workspace_ids

Array<string>

version

string

Example

1.0.0

notes

string

readme

string

include_sample_rows

boolean

preview_image

string

acknowledge_findings

boolean

Responses

201

Saved

403

Cannot edit the source

409

REVIEW_REQUIRED — findings and preview attached