Search skmtc…
⌘K
Docs
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Generate
Filter operations
auto_write
48
post
/api/v1/tools/create_alert
Create a metric-threshold automation that fires an alert when a KPI crosses a boundary. Supported metrics: roas, convers
post
/api/v1/tools/disable_automation
Disable an existing automation rule so it no longer fires. The row is kept for history; use list_automations to retrieve
post
/api/v1/tools/enable_automation
Re-enable a previously disabled automation. Flips automations.enabled to true. Reversible via disable_automation.
post
/api/v1/tools/run_calibration
Re-run self-calibration of this store's decision thresholds (winner/loser floors, etc.) using its own performance distri
post
/api/v1/tools/run_classification
Re-classify every product's performance tier based on current thresholds and 30-day metrics. Side-effect: products.perfo
post
/api/v1/tools/run_decide_dry
Run the decision engine in DRY-RUN mode. Produces decision_log rows with applied_to_shopify=false so Magistry can show w
post
/api/v1/tools/run_sync_catalog
Pull the latest product + variant metadata from Shopify. Read-side side-effect only: refreshes our cache of titles, pric
post
/api/v1/tools/run_sync_orders
Pull recent orders + line items from Shopify and refresh performance aggregates. days defaults to 7. Does not mutate Sho
post
/api/v1/tools/run_embeddings
Compute or refresh OpenAI text-embedding-3-small (1536-dim) vectors for products that lack them. Required before find_si
post
/api/v1/tools/run_anomaly_check
Detect performance anomalies (sudden CTR/CR drops, unusual spend) and surface them as alerts. Does not modify products.
post
/api/v1/tools/run_supplier_health
Score suppliers based on quality/availability/lead-time signals. Updates supplier_health_checks rows. Reversible by re-r
post
/api/v1/tools/run_cannibalization
Re-cluster products by image-text similarity and update product_clusters. Use this after large bulk syncs or when the us
post
/api/v1/tools/run_research
Kick off a research-pipeline pass: scans configured lanes (Meta Ad Library, AliExpress bestsellers, etc.) for new candid
post
/api/v1/tools/run_ab_resolve
Resolve any A/B tests whose statistical power has reached threshold. Updates ab_tests.resolution; does NOT change conten
post
/api/v1/tools/save_skill
Save a reusable prompt as a Magistry Skill so the user can re-run it via the /skill-name slash menu in the chat input. T
post
/api/v1/tools/delete_skill
Delete one of the user's saved Skills by id. Only the owner can delete. Reversible by re-running save_skill with the sam
post
/api/v1/tools/cs_triage_thread
Apply a reversible inbox action to one or more CS threads (mark read/unread, star/unstar, move to spam/trash/archive/inb
post
/api/v1/tools/tell_brain
Pass the merchant's direction to the Brain. Use `add_instruction` when they state a standing goal or guardrail ("stop di
post
/api/v1/tools/update_brand_kit
Changes the store's brand kit, only in the fields given; it is made if there is none. Colours are hex values for five na
post
/api/v1/tools/read_brand_from_website
Reads the store's brand from its own website (or another page given): the colours the page paints its buttons and surfac
post
/api/v1/tools/create_design
Starts a new design from a starting layout in the store's brand: blank, announcement (headline, support line and button)
post
/api/v1/tools/compose_design
Has the designer compose a new design from a written brief, in the store's brand, optionally built on images from the st
post
/api/v1/tools/create_campaign_set
Has the designer turn one brief into a campaign set: first a plan of several concepts that each lead with a different id
post
/api/v1/tools/edit_design
Has the designer change an existing design from an instruction ("make the headline shorter", "use the blue from the logo
post
/api/v1/tools/vary_design
Has the designer propose several distinct takes on the newest version of a design in one go, in a direction ("more premi
post
/api/v1/tools/translate_design
Makes one version of a design per language: the words translated and, on a video, the voice-over spoken in that language
post
/api/v1/tools/use_design_variation
Uses one take from a finished request for takes on a design. By default it is saved as a new version of the design it va
post
/api/v1/tools/add_design_music
Generates an original soundtrack for a motion design from a description of the mood and lays it under the whole design a
post
/api/v1/tools/set_design_audio
Sets the soundtrack of a motion design from the store's music library, saved as a new version: puts a track under the wh
post
/api/v1/tools/set_design_transition
Sets the transition on one join between two clips of a motion design, saved as a new version: a crossfade, whip, flash o
post
/api/v1/tools/set_design_sfx
Adds, changes or removes a sound effect of a motion design, saved as a new version. A new one takes a track id from the
post
/api/v1/tools/export_design
Exports a saved version of a design to files: png, jpg or webp for stills and mp4 for motion designs, one file per layou
post
/api/v1/tools/propose_design_post
Turns an exported file into a social post proposal for the store's connected accounts (Instagram, Facebook, TikTok, Pint
post
/api/v1/tools/propose_design_ad
Adds an exported file to one of the store's ad campaigns as a draft ad creative. It reaches the ad account only once som
post
/api/v1/tools/comment_on_design
Leaves a review comment on a design, or a reply in an existing thread. A comment can be pinned to a layer, to a point on
post
/api/v1/tools/resolve_design_comment
Marks a comment thread on a design as resolved, recording the newest version as the one that answered it, or reopens a r
post
/api/v1/tools/fix_design_comment
Asks the designer to make the change an open comment thread asks for: the thread's words, its replies and where it is pi
post
/api/v1/tools/fill_design_for_locations
Makes one design per store location from a design used as a template, filling only its open slots: {{location.name}}, {{
post
/api/v1/tools/bind_design_data
Links a text layer of a design to a field of one of the store's own records, so the words on the design come from the bu
post
/api/v1/tools/refresh_design_data
Brings the layers of a design that are linked to the store's records up to date: each one is made to show what its produ
post
/api/v1/provisioning/cancel
Stop a setup that is under way.
post
/api/v1/intent/release
Give up a field this app holds, leaving its current value in place.
post
/api/v1/intent/revert
Undo a declaration: put the field back to the value it had before this app wrote it.
post
/api/v1/approvals
Ask the merchant to approve something this app is about to do.
post
/api/v1/approvals/withdraw
Withdraw a pending request this app no longer needs.
post
/api/v1/policies
Add a rule that refuses or limits what may be written to the store.
post
/api/v1/policies/update
Change a rule this credential wrote.
post
/api/v1/policies/delete
Delete a rule this credential wrote.
propose_write
34
read
120
auto_write
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Adds, changes or removes a sound effect of a motion design, saved as a new version. A new one takes a track id from the
post
/api/v1/tools/set_design_sfx
Oct 20, 2026
13dae20d49cb
Revision changes
info
endpoint added