Keble API 与 MCPAPI v3获取密钥并连接你的 AI Agent

开发者文档

Keble API 与 MCP

通过 MCP 或 HTTPS 把你自己的 AI Agent 或代码接入 Keble：搜索市场数据、读取已连接的店铺、生成报告、管理待办，只需一把 API 密钥。

创建密钥登录后创建密钥

登录后创建一把 API 密钥。密钥只显示一次，请妥善保存。

连接你的 AI Agent

把下方配置粘贴到你的 AI 工具，或在代码里直接调用 REST 路由。

调用一个接口

例如：“用 Keble 看看我能查哪些数据。”你的 AI Agent 会调用 dp_catalog。

38 个接口 · 37 个 MCP 工具 · OpenAPI (JSON)

部分接口会消耗余额，每个接口都标明价格；每次调用都记录在用量日志中。价格 · 用量日志

认证与 MCP

写入 ~/.codex/config.toml

把占位符换成你在密钥页创建的密钥。登录后创建密钥

每次调用都在 Authorization 请求头里带上你的 API 密钥。同一把密钥可用于 MCP 和 HTTPS。

请求头

Authorization: Bearer PASTE_YOUR_KEY_HERE

MCP 地址

/api/v3/mcp

REST 地址

/api/v3

调用方式说明

HTTPS：接口为 POST <REST 地址>/gateway/<工具名>，请求体为 JSON；下载类接口为 GET，参数放在查询字符串里。通过 MCP 调用时，用 tools/call 传入工具名，并把同一份请求体放在 "request" 里。

API 密钥: 让你的 AI Agent 或代码代表你的账户操作，可随时在密钥页撤销。
MCP: AI 工具调用 Keble 这类服务的开放协议。
接口: 一个可调用的操作；它的名称既是 REST 路径的最后一段，也是 MCP 工具名。

API 参考

API 密钥可调用的全部接口。每个接口都是一个 REST 路由（除下载表格外均为 POST）；标注了 MCP 的，同时是同名的 MCP 工具，两者参数是同一份 JSON。字段说明为英文。

数据

搜索数据MCP 工具 · dp_search

POST/api/v3/gateway/dp_search

回答一个市场问题，或对商品、内容、达人、关键词和趋势做结构化搜索。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 内容数据 ¥0.0140/行 · 计 1 次请求达人数据 ¥0.0140/行 · 计 1 次请求关键词数据 ¥0.0140/行 · 计 1 次请求

请求体 · SearchRequest

参数

One question or structured search with an optional per-call row ceiling.

`maxRows`可选integer \| null	Optional row ceiling for this call; the smaller of this and the normal page size is returned. Omission preserves the normal page size.
`answerLanguage`可选AnswerLanguage	Language of seller-facing clarifications and refusals. 默认: `"EN"`
`question`可选string \| null	The natural-language question to answer.
`search`可选Search \| null	The typed structured search to execute.
`hints`可选RouteHints \| null	Optional predicates pinned into the stored plan.
`clarification`可选ClarificationAnswer \| null	The stored clarification choice being resumed.
`fields`可选string[] \| null	Authorized display-field whitelist; null means all authorized fields.

返回 · CustomerDpSearchResponse

Expose the full discriminated DP search answer without copying DP fields.

curl -X POST \
  "/api/v3/gateway/dp_search" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"question":"best running shoes"}'

搜索下一页MCP 工具 · dp_continue

POST/api/v3/gateway/dp_continue

认证: API 密钥：Authorization: Bearer <密钥>
价格: 内容数据 ¥0.0140/行 · 计 1 次请求

请求体 · ContinueRequest

参数

A signed continuation request with an optional per-call row ceiling.

`cursor`必填string	Opaque signed continuation token.
`maxRows`可选integer \| null	Optional row ceiling for this call; the next cursor follows the last returned row. Omission preserves the normal page size.

返回 · CustomerDpContinueResponse

Expose one discriminated DP continuation answer.

以下之一: SearchPage | EntityPage | SearchPending | SearchRefused · 区分字段 object

curl -X POST \
  "/api/v3/gateway/dp_continue" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"example.continuation.token"}'

可查数据MCP 工具 · dp_catalog

POST/api/v3/gateway/dp_catalog

列出现在能搜索的平台和数据类型。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · DpCatalogRequest

参数

The dp_catalog request: the caller only chooses whether DP's per-channel pairs are included.

includePairs可选boolean

Also list each channel's start-to-result pairs (planner-admitted walks, with analyzed and live modes); off by default because the list is large.

默认: false

返回 · CustomerDpCatalogResponse

Expose the DP catalog or its typed refusal as one customer root schema.

以下之一: CapabilityCatalog | SearchRefused · 区分字段 object

curl -X POST \
  "/api/v3/gateway/dp_catalog" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

数据新鲜度MCP 工具 · dp_freshness

POST/api/v3/gateway/dp_freshness

每类可搜索数据有多新。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · NoArguments

参数

无参数，发送 {} 即可。

返回 · CustomerDpFreshnessResponse

Expose the DP freshness projection or its typed refusal.

以下之一: Freshness | SearchRefused · 区分字段 object

curl -X POST \
  "/api/v3/gateway/dp_freshness" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

记录详情MCP 工具 · dp_record

POST/api/v3/gateway/dp_record

一条搜索结果的全部字段，以及它关联的内容。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 内容数据 ¥0.0140/行 · 计 1 次请求达人数据 ¥0.0140/行 · 计 1 次请求

请求体 · RecordAddress

参数

The ONE public record address: one analyzed record's kind and key.

`kind`必填AnalyzedRecordKind
`recordKey`必填string
`seriesWindow`可选DateWindow \| null	Inclusive date window for an opt-in record-level metric series; null requests no series.

返回 · CustomerDpRecordResponse

Expose one DP record detail or its typed refusal.

以下之一: RecordDetail | SearchRefused · 区分字段 object

curl -X POST \
  "/api/v3/gateway/dp_record" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"kind":"NODE","recordKey":"CONTENT:public:example"}'

趋势元素MCP 工具 · dp_motifs

POST/api/v3/gateway/dp_motifs

某个分区里正在扩散或刚开始流行的元素。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · MotifQuery

参数

One named motif section and window with an optional row ceiling.

`days`可选integer \| null	Length in days of the current window; null when start/end state the span.
`start`可选string \| null	Inclusive first day of an explicit span.
`end`可选string \| null	Inclusive last day of the current window; null uses the newest member publication day in scope.
`section`必填MotifSection
`terms`可选string[]	Word-match terms tested against each member's label or instance, or the member content's searchable fields; at most eight. 默认: `[]`
`maxRows`可选integer \| null	Optional row ceiling for this motif page; the smaller of this and the normal page size is returned. Omission preserves the normal page size.

返回 · CustomerDpMotifsResponse

Expose one DP motif page, its pending variant or a typed refusal.

以下之一: EntityPage | SearchPending | SearchRefused · 区分字段 object

curl -X POST \
  "/api/v3/gateway/dp_motifs" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"section":"SPREADING"}'

店铺连接

可连接来源MCP 工具 · elta_catalog

POST/api/v3/gateway/elta_catalog

可以连接的店铺和数据来源。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · NoArguments

参数

无参数，发送 {} 即可。

返回 · PluginDeclarationCatalog

Every installed plugin's declaration plus the shared vocabulary.

`object`可选string	Document type: catalog. 可选值: `catalog` 默认: `"catalog"`
`declarations`必填PluginDeclaration[]	Declarations of every installed plugin.
`levels`可选EntityLevel[]	Every level a value may carry, with its title and parent. 默认: `[]`
`refusals`可选WriteRefusal[]	Every refusal an action row may carry, with its title and meaning. 默认: `[]`

curl -X POST \
  "/api/v3/gateway/elta_catalog" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

我的店铺MCP 工具 · elta_stores

POST/api/v3/gateway/elta_stores

已连接的店铺、它们的连接方式和同步状态。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · NoArguments

参数

无参数，发送 {} 即可。

返回 · StoresResponse

The stores belonging to the asserted owner, including unfinished stores.

`object`可选string	Document type: stores response. 可选值: `stores_response` 默认: `"stores_response"`
`stores`必填StoreRecord[]	Stores belonging to the asserted owner.

curl -X POST \
  "/api/v3/gateway/elta_stores" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

店铺可用能力MCP 工具 · elta_store_capabilities

POST/api/v3/gateway/elta_store_capabilities

一个店铺现在能做什么：哪些实时查询、修改和数据可用，以及其余项因何不可用。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ResumeStoreRequest

参数

One store, addressed by its id.

storeId必填string

The store's id.

返回 · StoreCapabilities

What the installed sources can do right now for one store: live reads, writes and captures.

`object`可选string	Document type: store capabilities. 可选值: `store_capabilities` 默认: `"store_capabilities"`
`storeId`必填string	Store whose current abilities this document describes.
`lookups`必填CapabilityRow[]	Installed live reads: one row per (key, account).
`actions`必填CapabilityRow[]	Installed provider writes: one row per (key, account).
`datasets`必填CapabilityRow[]	Installed captured datasets: one row per (key, account).

curl -X POST \
  "/api/v3/gateway/elta_store_capabilities" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"storeId":"store_1"}'

店铺指标MCP 工具 · elta_metrics

POST/api/v3/gateway/elta_metrics

已连接店铺的已存指标。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · MetricsRequest

参数

A serving read of one or more metrics over a date range, current values only.

`metricKeys`必填string[]	Metrics to read; at least one.
`level`必填string	The entity level key the caller wants values at.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

返回 · MetricPage

One bounded page of combined range values: the /v2/metrics/query response.

`rows`必填MetricRangeValue[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Fixed tag marking this object as a metric page. 可选值: `metric_page` 默认: `"metric_page"`

curl -X POST \
  "/api/v3/gateway/elta_metrics" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"metricKeys":["acos"],"level":"CAMPAIGN","days":{"startsOn":"2026-09-01","endsOn":"2026-09-02"}}'

店铺数据MCP 工具 · elta_facts

POST/api/v3/gateway/elta_facts

已连接店铺的已存数据，例如广告活动和出价。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · FactsRequest

参数

A serving read of stored facts for one owner: family, days, selection and pin.

`familyKey`必填string	The fact family to read.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`attributes`可选AttributeMatch[]	View selections that restrict which rows are returned. 默认: `[]`
`asOf`可选string \| null	Instant to read as of; set this or capture_id, never both.
`captureId`可选string \| null	Committed capture to read as of; set this or as_of, never both.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

返回 · FactPage

One bounded page of fact rows plus the coverage of every requested day.

`rows`必填FactRow[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Fixed tag marking this object as a fact page. 可选值: `fact_page` 默认: `"fact_page"`
`coverage`必填DayCoverage[]	Coverage of every requested account, family and day.
`readAsOf`必填string	The single instant all rows were read at.
`blocked`可选BlockedLane[]	Blocked lanes with their reason and fix. 默认: `[]`

curl -X POST \
  "/api/v3/gateway/elta_facts" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"familyKey":"amazon.ads.sp_campaign_daily","days":{"startsOn":"2026-09-01","endsOn":"2026-09-02"}}'

数据历史MCP 工具 · elta_fact_history

POST/api/v3/gateway/elta_fact_history

一条已存数据随时间的变化。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · FactsRequest

参数

A serving read of stored facts for one owner: family, days, selection and pin.

`familyKey`必填string	The fact family to read.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`attributes`可选AttributeMatch[]	View selections that restrict which rows are returned. 默认: `[]`
`asOf`可选string \| null	Instant to read as of; set this or capture_id, never both.
`captureId`可选string \| null	Committed capture to read as of; set this or as_of, never both.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

返回 · FactHistoryResponse

One bounded page of every stored version, superseded ones included.

`rows`必填FactVersion[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Fixed tag marking this object as a fact history page. 可选值: `fact_history_response` 默认: `"fact_history_response"`

curl -X POST \
  "/api/v3/gateway/elta_fact_history" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"familyKey":"amazon.ads.sp_campaign_daily","days":{"startsOn":"2026-09-01","endsOn":"2026-09-02"}}'

店铺变化MCP 工具 · elta_changes

POST/api/v3/gateway/elta_changes

店铺已存数据的近期变化。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ChangesRequest

参数

A serving read of derived fact changes for one owner: the fact read's own selection.

`familyKey`必填string	The fact family to read.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`attributes`可选AttributeMatch[]	View selections that restrict which rows are returned. 默认: `[]`
`asOf`可选string \| null	Instant to read as of; set this or capture_id, never both.
`captureId`可选string \| null	Committed capture to read as of; set this or as_of, never both.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

返回 · FactChangePage

One bounded page of derived fact changes; total_rows counts every change matched.

`rows`必填FactChange[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.

curl -X POST \
  "/api/v3/gateway/elta_changes" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"familyKey":"amazon.ads.sp_campaign_daily","days":{"startsOn":"2026-09-01","endsOn":"2026-09-02"}}'

实时查询店铺MCP 工具 · elta_lookup

POST/api/v3/gateway/elta_lookup

直接从店铺读取当前数据。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · LookupRequest

参数

One live read pinned to an owner-visible store and optional stored account.

`storeId`必填string	Owner-visible store to read.
`lookupKey`必填string	The declared lookup to run.
`accountId`可选string \| null	Stored account to read; required when the source has several.
`query`必填JsonValue	The lookup's own query payload.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

返回 · LookupPage

One bounded page of live results; next_cursor is the provider's page token.

`object`可选string	Fixed tag marking this object as a lookup page. 可选值: `lookup_page` 默认: `"lookup_page"`
`rows`必填JsonValue[]	The result rows in the lookup's own shape.
`nextCursor`可选string \| null	Cursor continuing to the next page; none on the last page.

curl -X POST \
  "/api/v3/gateway/elta_lookup" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"storeId":"store_1","lookupKey":"google.gmail.search","accountId":"acct_1","query":{"q":"from:acme"}}'

查询店铺数据MCP 工具 · elta_query

POST/api/v3/gateway/elta_query

筛选并汇总店铺的已存数据。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · QueryRequest

参数

Select a logical target and optionally narrow the authenticated owner's stores/accounts.

`target`必填QueryTarget	Catalog fact family to read, or METRIC_DAYS for calculated daily values.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to include within those stores; empty selects all their accounts. 默认: `[]`
`pipeline`必填QueryStage[]	Read-only aggregation stages over the selected logical rows.
`page`可选PageRequest	Page size and continuation cursor for this exact read. 默认: `{"limit":200}`

返回 · QueryPage

One bounded aggregation result page, reusing the shared cursor/total contract.

`rows`必填QueryRow[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Document type: aggregation query page. 可选值: `query_page` 默认: `"query_page"`

curl -X POST \
  "/api/v3/gateway/elta_query" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"target":"METRIC_DAYS","pipeline":[{"$limit":10}]}'

预览还原MCP 工具 · elta_preview_revert

POST/api/v3/gateway/elta_preview_revert

检查已记录的店铺修改能否还原，不会提交任何提议。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · RevertRequest

参数

Ask the service to construct the undo of one proposal; callers choose rows, never undo values.

`proposalId`必填string	Proposal to revert.
`actionKeys`可选string[]	Optional rows to revert; empty means every revertible row. 默认: `[]`
`replayKey`可选string \| null	Caller-owned idempotency key.
`attribution`可选ProposalAttribution \| null	Origin and reason of this undo; excluded from its hash.

返回 · PreviewView

Stateless answer to a preview request, with outcomes and diffs aligned to its batch.

`batch`必填ActionBatch	Requested action batch; nothing is persisted by preview.
`previews`必填ActionOutcome[]	One live outcome per action, in order.
`diffs`必填ActionDiff[]	One derived diff per action, in order.

curl -X POST \
  "/api/v3/gateway/elta_preview_revert" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"proposalId":"proposal_1"}'

报告

创建报告MCP 工具 · artifect_create

POST/api/v3/gateway/artifect_create

开始一份定位分析或亚马逊产品报告；同一个幂等键重复提交返回第一次的任务。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 亚马逊产品报告 ¥0.7000/次 · 计 5 次请求产品定位 ¥0.7000/次 · 计 5 次请求广告优化建议 ¥0.7000/次 · 计 5 次请求产品图片 ¥0.7000/次

参数

Carry the complete V3 report premise accepted by the runtime.

`kind`可选string	可选值: `AMZ_PRODUCT_REPORT` 默认: `"AMZ_PRODUCT_REPORT"`
`replayKey`必填string
`asin`必填string
`amazonMarketplace`必填AmazonMarketplace
`keywords`可选string[]	Discovery keywords; suggest keywords, the seller confirms; at least one nonblank keyword with categoryId skips REPORT_SCOPE; otherwise the run parks on REPORT_SCOPE to ask. 默认: `[]`
`categoryId`可选integer \| null	Confirmed Amazon category; with at least one nonblank keyword it skips REPORT_SCOPE.
`title`可选string \| null
`image`可选string \| null
`language`可选Language \| null
`similarProductsLimit`可选integer \| null	How many comparable products to analyse; None keeps the runtime's website-aligned default.
`economicSetup`可选ReportProfileEconomicFields \| null	The seller's economic setup in the report package's own field names (ACOS band, fixed size/weight, entry-budget threshold). Its suggestedPurchasingCost is refused when purchaseCost is sent, so the seller's cost has ONE create source; a later PROFILE_INPUTS edit changes the benchmark, never a PROFIT_INPUTS override of the analysed product.
`purchaseCost`必填ArtifectReportUserPurchaseCost \| ArtifectReportSystemEstimatedPurchaseCost	Required seller-confirmed cost: show Keble's estimate as a suggestion, confirm the cost (single or range) with the seller before creating; later changes to the seller's own cost go through PROFILE_INPUTS and re-price every product; competitors' costs can be changed one by one or as a set through PROFIT_INPUTS.

Carry the source-agnostic premise for one positioning study.

`kind`可选string	可选值: `POSITIONING` 默认: `"POSITIONING"`
`replayKey`必填string
`positioningContext`必填string
`pluginId`可选string \| null	Installed plugin ID; omit for the host default. Setup must match this plugin's declaration.
`setup`可选object \| null	Values for the selected plugin's declared setup fields; omitted fields are proposed at SCOPE.
`language`可选Language \| null

Start one on-demand Ads optimization-suggestions run for one store.

`kind`可选string	可选值: `AMZ_ADS_ADVICE` 默认: `"AMZ_ADS_ADVICE"`
`replayKey`必填string
`storeId`必填string
`anchorDay`可选string \| null	Requested data day; null means yesterday in UTC; a later day is refused before any source is read.
`language`可选Language \| null

Create one product-image set from photos already uploaded through the image artifect.

`kind`可选string	可选值: `PRODUCT_IMAGES` 默认: `"PRODUCT_IMAGES"`
`request`必填CreateImageSet

Create one Shopify theme document workspace from the theme contract's document request.

kind可选string

可选值: SHOPIFY_THEME_UPDATE

默认: "SHOPIFY_THEME_UPDATE"

request必填ThemeDocumentCreateRequest

Start one theme workspace on a connected store: pages are edited as Keble sections and settings, previewed on an unpublished copy of the theme and then published; the theme's own files are never edited. Use this kind, not raw elta_propose shopify.admin.theme_file writes, to add or change sections on a store page. Omit targetThemeId to target the live theme; a targetThemeId the store does not have is refused with the store's themes (name, role, id). Previewing and publishing need theme edits turned on for the store ("Edit themes" under Connectors › store › Allow Keble to change; elta_store_capabilities shows it as shopify.admin.themes): check it before drafting and ask the person to turn it on if it is off. Cancel does not close or discard a workspace: it stays open and nothing is published; DISCARD_PREVIEW removes the preview copy. A stale base revision is REVISION_CONFLICT; other refusals carry kindCode: RUN_NOT_FOUND (No such theme run for this account; list the runs to find it.); WRONG_RUN_KIND (Use the commands of this run's kind; read its snapshot first.); STORE_NOT_FOUND (Connect the store first, then create the run.); TARGET_NOT_IN_STORE (Pick one of the store's themes as the target.); REPLAY_KEY_REUSED (Use a new replay key for a different create request.); UNKNOWN_REVISION (Name a revision this run has.); UNKNOWN_PAGE (Add the page for that template first.); UNKNOWN_SECTION (Use a section key from the snapshot.); UNKNOWN_BLOCK (Use a block key of that section from the snapshot.); UNKNOWN_SECTION_KIND (Use one of the library's section kinds.); UNKNOWN_SETTING (Use a setting declared for that section or block kind.); SETTING_OUT_OF_BOUNDS (Keep the value within the setting's type and bounds.); DUPLICATE_KEY (Choose a template, section key or block key not used yet.); BLOCK_NOT_ALLOWED (That section kind takes no blocks of this kind.); TOO_MANY_BLOCKS (Remove a block before adding another.); ANCHOR_NOT_FOUND (Place the section after an entry the page still has.); TEMPLATE_NOT_PLACEABLE (Place sections only on the theme's existing page templates.); THEME_LIBRARY_FULL (The store already holds 20 themes, Shopify's maximum; delete an unused theme in Shopify Admin.); THEME_PROCESSING (Shopify is still creating the preview copy; update the preview again shortly.); PREVIEW_COPY_UNKNOWN (The preview copy may exist; find it in Shopify Admin by its name and remove it.); NO_PREVIEW_COPY (There is no preview copy yet; UPDATE_PREVIEW makes one.); PREVIEW_NOT_READY (Update the preview and wait until the copy shows this revision.); PROPOSAL_PENDING (A request for this step is still applying; retry shortly.); BASE_CHANGED (The theme changed since it was read; publish again to re-merge.); NOTHING_TO_PROPOSE (The theme already shows this version; there is nothing to change.); PREVIEW_REJECTED (A write was refused before filing, so nothing was filed; resolve its reason (FAMILY_OFF: turn on theme edits for the store), then repeat the step.)

Carry one account-free change-list create premise to its configured host.

`kind`必填string	可选值: `AMZ_LISTING_CHANGESSHOPIFY_ARTICLE_CHANGESSHOPIFY_SEO_CHANGESSHOPIFY_GEO_CHANGESAMZ_ADS_CHANGES`
`request`必填ChangeListCreatePremise

Create one guided Shopify blog post set from the kind's own BlogCreate.

`kind`可选string	可选值: `SHOPIFY_BLOG_POSTS` 默认: `"SHOPIFY_BLOG_POSTS"`
`request`必填BlogCreate

Create one unpublished Shopify product draft from the kind's ProductCreateRequest.

`kind`可选string	可选值: `SHOPIFY_PRODUCT` 默认: `"SHOPIFY_PRODUCT"`
`request`必填ProductCreateRequest

Create one owner-fenced new Amazon listing draft from the kind's own ListingCreate.

`kind`可选string	可选值: `AMZ_LISTING` 默认: `"AMZ_LISTING"`
`request`必填ListingCreate

Create one Amazon FBA inbound plan artifect and file its plan proposal.

`kind`可选string	可选值: `AMZ_FBA_INBOUND_PLAN` 默认: `"AMZ_FBA_INBOUND_PLAN"`
`replayKey`必填string
`storeId`必填string
`accountId`可选string \| null
`change`必填object	ELTA action `amazon.seller.create_fba_inbound_plan`'s change, passed through unchanged except for one default. Required: `source_address` (the private ship-from address, its `phone_number` included) and `items` (at least one row, each with `msku`, `quantity` > 0, `prep_owner` and `label_owner`). A row that omits `prep_owner` is filed with `SELLER`: Amazon refuses `NONE` for an item that needs prep, and Amazon US ended its own prep service on 2026-01-01, so `SELLER` is the safe choice there and `AMAZON` is never accepted for prep in the US. `name` is the plan's optional name. Full schema: elta_catalog actions[key=amazon.seller.create_fba_inbound_plan].changeSchema.

Create one MONITOR draft (a standing artifect), parked on its setup input.

`kind`可选string	可选值: `MONITOR` 默认: `"MONITOR"`
`replayKey`必填string
`title`必填string

返回 · CustomerArtifectCreateResponse

Expose an Artifect reference or sanitized Artifect failure.

以下之一: ArtifectRef | ArtifectAccountRequired | ArtifectFailure · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_create" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"kind":"AMZ_PRODUCT_REPORT","replayKey":"example-replay-1","asin":"B0EXAMPLE1","amazonMarketplace":"US","purchaseCost":{"source":"SYSTEM_ESTIMATED","sellerAgreed":true}}'

回答报告MCP 工具 · artifect_answer

POST/api/v3/gateway/artifect_answer

回答报告的待答问题，让它继续。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectAnswerRequest

参数

Which run, and the typed decision fragment (own input key, revision and replay_key).

`ref`必填ArtifectRef
`answer`必填ArtifectAnswer

返回 · CustomerArtifectDecisionResponse

Expose an Artifect decision status, rejection or sanitized failure.

以下之一: ArtifectStatus | ArtifectDecisionRejection | ArtifectFailure | ArtifectProductImagesQuote · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_answer" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"ref":{"id":"artifect_1"},"answer":{"inputKey":"REPORT_SCOPE:a1b2c3d4","expectedRevision":0,"replayKey":"example-answer-1","decision":{"decisionType":"REPORT_SCOPE","categoryId":1,"keywords":["running shoes"]}}}'

调整报告MCP 工具 · artifect_adjust

POST/api/v3/gateway/artifect_adjust

修改报告里已完成的一个决策。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectAdjustRequest

参数

Which run and typed adjustment; removed arms retain ordinary INVALID_REQUEST validation.

`ref`必填ArtifectRef
`adjust`必填ArtifectAdjust

返回 · CustomerArtifectDecisionResponse

Expose an Artifect decision status, rejection or sanitized failure.

以下之一: ArtifectStatus | ArtifectDecisionRejection | ArtifectFailure | ArtifectProductImagesQuote · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_adjust" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"ref":{"id":"artifect_1"},"adjust":{"baseRevision":0,"replayKey":"example-adjust-1","adjustment":{"adjustmentType":"EXCLUDE_ASINS","asins":["B0EXAMPLE1"]}}}'

取消报告MCP 工具 · artifect_cancel

POST/api/v3/gateway/artifect_cancel

取消正在运行的报告。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectRef

参数

Identify one durable Artifect instance by its opaque public id.

`object`可选string	可选值: `artifect_ref` 默认: `"artifect_ref"`
`id`必填string

返回 · CustomerArtifectStatusResponse

Expose an Artifect lifecycle status or sanitized failure.

以下之一: ArtifectStatus | ArtifectFailure · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_cancel" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"id":"artifect_1"}'

报告进度MCP 工具 · artifect_status

POST/api/v3/gateway/artifect_status

报告进行到哪一步，以及它在等待什么。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectRef

参数

Identify one durable Artifect instance by its opaque public id.

`object`可选string	可选值: `artifect_ref` 默认: `"artifect_ref"`
`id`必填string

返回 · CustomerArtifectStatusResponse

Expose an Artifect lifecycle status or sanitized failure.

以下之一: ArtifectStatus | ArtifectFailure · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_status" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"id":"artifect_1"}'

报告待答问题MCP 工具 · artifect_read_input

POST/api/v3/gateway/artifect_read_input

报告正在等待的输入及其选项。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectInputRequest

参数

One page of the input a parked run offers.

`ref`必填ArtifectRef
`inputKey`必填string
`cursor`可选string \| null
`maxItems`可选integer \| null

返回 · CustomerArtifectInputResponse

Expose an Artifect input page, a terminal-run rejection or a sanitized failure.

以下之一: CustomerArtifectInputPage | ArtifectDecisionRejection | ArtifectFailure · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_read_input" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"ref":{"id":"artifect_1"},"inputKey":"DIMENSIONS:a1b2c3d4"}'

读取报告MCP 工具 · artifect_snapshot

POST/api/v3/gateway/artifect_snapshot

报告当前的结果。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectSnapshotRequest

参数

Which run, which immutable revision (None is the head) and which board objects to focus.

`ref`必填ArtifectRef
`revision`可选integer \| null
`focus`可选string[]	默认: `[]`

返回 · CustomerArtifectSnapshotResponse

Expose an Artifect snapshot or sanitized failure.

以下之一: ArtifectSnapshot | ArtifectFailure · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_snapshot" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"ref":{"id":"artifect_1"}}'

读取报告明细MCP 工具 · artifect_detail

POST/api/v3/gateway/artifect_detail

按报告自身的类型，读取其中一部分，例如一个商品、一个单元格或一行广告建议。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectDetailRequest

参数

Address one artifect and ask it one kind-typed detail question.

`ref`必填ArtifectRef
`query`必填ArtifectReportDetailQuery \| ArtifectPositioningDetailQuery \| ArtifectAdsAdviceDetailQuery \| ArtifectProductImagesDetailQuery \| ArtifectShopifyThemeQuery \| ArtifectMonitorDetailQuery \| ArtifectOccurrencesQuery

返回 · CustomerArtifectDetailResponse

Expose one kind-typed Artifect detail answer or sanitized failure.

以下之一: ArtifectDetail | ArtifectFailure · 区分字段 object

curl -X POST \
  "/api/v3/gateway/artifect_detail" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"ref":{"id":"artifect_1"},"query":{"kind":"AMZ_PRODUCT_REPORT","query":{"object":"report_listing","asin":"B0EXAMPLE1"}}}'

定位插件MCP 工具 · artifect_plugins

POST/api/v3/gateway/artifect_plugins

定位分析可以使用的插件。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · NoArguments

参数

无参数，发送 {} 即可。

返回 · CustomerArtifectPluginListResponse

Expose the installed positioning plugins in a JSON-object envelope.

`object`可选string	可选值: `artifect_plugin_list` 默认: `"artifect_plugin_list"`
`plugins`必填RoomPublicDeclaration[]

curl -X POST \
  "/api/v3/gateway/artifect_plugins" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

我的报告MCP 工具 · artifect_runs

POST/api/v3/gateway/artifect_runs

你自己的报告任务，按时间从新到旧分页列出；不填类型即列出全部类型。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectRunsRequest

参数

Which of the caller's own Artifect runs to list, newest first.

`kind`可选ArtifectKind \| null
`storeId`可选string \| null
`limit`可选integer	默认: `5`
`before`可选string \| null

返回 · ArtifectRunList

One newest-first page; next_before is set only when an older run exists.

`object`可选string	可选值: `artifect_run_list` 默认: `"artifect_run_list"`
`runs`必填ArtifectRunItem[]
`nextBefore`可选string \| null

curl -X POST \
  "/api/v3/gateway/artifect_runs" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"kind":"AMZ_ADS_ADVICE","storeId":"st_1"}'

报告类型说明MCP 工具 · artifect_describe

POST/api/v3/gateway/artifect_describe

一种报告类型的名称、用途，以及创建、调整、回答和明细调用所接受的确切字段。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ArtifectDescribeRequest

参数

Which kind's request bodies to describe.

kind必填string

Identify the workflow family handled by an Artifect runtime.

可选值: AMZ_PRODUCT_REPORTPOSITIONINGAMZ_ADS_ADVICEPRODUCT_IMAGESSHOPIFY_THEME_UPDATEAMZ_LISTING_CHANGESSHOPIFY_ARTICLE_CHANGESSHOPIFY_SEO_CHANGESSHOPIFY_GEO_CHANGESAMZ_ADS_CHANGESSHOPIFY_BLOG_POSTSSHOPIFY_PRODUCTAMZ_LISTINGAMZ_FBA_INBOUND_PLANMONITOR

返回 · ArtifectKindDescription

One hosted kind's label, purpose and exact request bodies as one JSON Schema document.

`kind`必填ArtifectKind
`label`必填string
`purpose`必填string
`requestSchema`必填object

curl -X POST \
  "/api/v3/gateway/artifect_describe" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"kind":"AMZ_PRODUCT_REPORT"}'

添加图片链接MCP 工具 · artifect_photo_links

POST/api/v3/gateway/artifect_photo_links

保存你自己商品图片的 HTTPS 链接，或仅用作风格参考的公开图片链接；参考图片不会被当作你的商品图片。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · PhotoLinksRequest

参数

HTTPS images stored as owner photos or scene-only references in one bounded intake.

`urls`必填string[]
`origin`可选string	可选值: `UPLOADREFERENCE` 默认: `"UPLOAD"`

返回 · PhotoLinksAdded

The one owner-scoped intake result plus one typed problem per link that produced no photo.

`intake`必填PhotosAdded \| IntakeRefusal
`problems`可选PhotoLinkProblem[]	默认: `[]`

curl -X POST \
  "/api/v3/gateway/artifect_photo_links" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://images.example.com/reference.jpg"],"origin":"REFERENCE"}'

下载建议表格

GET/api/v3/gateway/artifect_workbook

把一次广告优化建议导出为 Excel 文件。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

参数

`ref`必填string	The run to download.
`language`必填Language	Language of the workbook labels.

curl -G \
  "/api/v3/gateway/artifect_workbook" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  --data-urlencode "ref=<ref>" \
  --data-urlencode "language=<language>"

修改与待办

进行店铺修改MCP 工具 · elta_propose

POST/api/v3/gateway/elta_propose

进行一次店铺修改，例如出价或预算；该店铺对应的写入开关开启时立即应用，关闭时会被拒绝，不会提交任何内容。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ActionBatch

参数

One non-empty proposal batch with a unique caller-owned key for each action.

actions必填ProviderAction[]

Requested actions in order, each with a unique action_key.

返回 · ApprovalView

The inbox item and the proposal's current state shown to a person.

`item`必填ApprovalItem
`proposal`必填ProposalView

curl -X POST \
  "/api/v3/gateway/elta_propose" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"actions":[{"actionKey":"example-action-1","actionTypeKey":"amazon.ads.set_target_bid","account":{"connectionId":"conn_1","accountId":"acct_1","timezone":"UTC"},"target":{"level":"TARGET","entity":"target_1"},"change":{"bid":"0.90"}}]}'

还原店铺修改MCP 工具 · elta_propose_revert

POST/api/v3/gateway/elta_propose_revert

还原一次已记录的店铺修改；店铺支持撤销时立即应用。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · RevertRequest

参数

Ask the service to construct the undo of one proposal; callers choose rows, never undo values.

`proposalId`必填string	Proposal to revert.
`actionKeys`可选string[]	Optional rows to revert; empty means every revertible row. 默认: `[]`
`replayKey`可选string \| null	Caller-owned idempotency key.
`attribution`可选ProposalAttribution \| null	Origin and reason of this undo; excluded from its hash.

返回 · ApprovalView

The inbox item and the proposal's current state shown to a person.

`item`必填ApprovalItem
`proposal`必填ProposalView

curl -X POST \
  "/api/v3/gateway/elta_propose_revert" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"proposalId":"proposal_1"}'

查看审批MCP 工具 · approval_view

POST/api/v3/gateway/approval_view

查看一条修改提议的审批状态。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · ApprovalViewRequest

参数

Select an approval by its existing item id or its proposal id.

`itemId`可选string \| null	Existing owner-scoped inbox item id.
`proposalId`可选string \| null	Proposal id, resolved through its owner-scoped inbox key.

返回 · ApprovalView

The inbox item and the proposal's current state shown to a person.

`item`必填ApprovalItem
`proposal`必填ProposalView

curl -X POST \
  "/api/v3/gateway/approval_view" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"itemId":"item_1"}'

添加待办MCP 工具 · todo_create

POST/api/v3/gateway/todo_create

添加一条待办；同一个幂等键重复提交返回第一条。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · TodoCreate

参数

Immutable original intent for an ordinary todo.

`kind`可选string	可选值: `TODO` 默认: `"TODO"`
`content`必填ItemContent
`key`可选string \| null

返回 · CreateResult

Stored item and whether the call admitted a new row.

`object`可选string	可选值: `create_result` 默认: `"create_result"`
`item`必填TodoItem \| AlertItem \| ApprovalItem \| NotificationItem
`created`必填boolean

curl -X POST \
  "/api/v3/gateway/todo_create" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"content":{"title":"Review the weekly report"}}'

完成待办MCP 工具 · todo_complete

POST/api/v3/gateway/todo_complete

把一条待办标记为完成。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · InboxItemRef

参数

Which inbox item a read or completion names (one tool/route input).

itemId必填string

返回 · TodoItem

Ordinary todo with immutable creation and mutable current content.

`id`必填string
`owner`必填OwnerRef
`current`必填ItemContent
`created_at`必填string
`revision`必填integer
`created_by`可选ActorRef \| null
`kind`可选string	可选值: `TODO` 默认: `"TODO"`
`object`可选string	可选值: `todo_item` 默认: `"todo_item"`
`creation`必填TodoCreate
`status`必填TodoStatus
`resolved_by`可选ActorRef \| null

curl -X POST \
  "/api/v3/gateway/todo_complete" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"itemId":"item_1"}'

撤回待办MCP 工具 · todo_withdraw

POST/api/v3/gateway/todo_withdraw

撤回你的 AI Agent 创建且仍未处理的待办或审批请求；人创建的事项不受影响。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · InboxItemRef

参数

Which inbox item a read or completion names (one tool/route input).

itemId必填string

返回 · CustomerInboxItemResponse

Expose the inbox owner's todo/approval union without copying either item model.

以下之一: TodoItem | AlertItem | ApprovalItem | NotificationItem · 区分字段 kind

curl -X POST \
  "/api/v3/gateway/todo_withdraw" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"itemId":"item_1"}'

待处理事项MCP 工具 · inbox_pending

POST/api/v3/gateway/inbox_pending

你未完成的待办和待审批事项。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · InboxPendingRequest

参数

One pending page: an opaque cursor and a bounded size (one tool/route input).

`cursor`可选string \| null
`limit`可选integer	默认: `20`

返回 · ItemPage

One ranked pending page and the owner's full matching open count.

`object`可选string	可选值: `item_page` 默认: `"item_page"`
`items`必填TodoItem[] \| AlertItem[] \| ApprovalItem[] \| NotificationItem[]
`next_cursor`可选string \| null
`total`必填integer

curl -X POST \
  "/api/v3/gateway/inbox_pending" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{}'

单条事项MCP 工具 · inbox_get

POST/api/v3/gateway/inbox_get

任意状态的一条待办或审批。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 免费

请求体 · InboxItemRef

参数

Which inbox item a read or completion names (one tool/route input).

itemId必填string

返回 · CustomerInboxItemResponse

Expose the inbox owner's todo/approval union without copying either item model.

以下之一: TodoItem | AlertItem | ApprovalItem | NotificationItem · 区分字段 kind

curl -X POST \
  "/api/v3/gateway/inbox_get" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"itemId":"item_1"}'

工具

利润测算MCP 工具 · amz_profit_calculate

POST/api/v3/gateway/amz_profit_calculate

根据成本和物流配置，计算一个商品的利润明细。

认证: API 密钥：Authorization: Bearer <密钥>
价格: 利润测算计 1 次请求

请求体 · AmzProfitCalculateRequest

参数

One product's cost and shipping observations for the profit calculator.

`costProfile`必填CostProfile
`shippingProfile`必填ShippingProfile
`shippingMode`可选ShippingMode	默认: `"FREIGHT"`
`isPeakPeriod`可选boolean	默认: `false`

返回 · ProfitBreakdown

One coherent scenario's exact selling-price-to-profit waterfall.

`scenarioKey`必填string
`role`必填ScenarioRole
`shippingMode`必填ShippingMode
`isPeakPeriod`必填boolean
`sellingPrice`必填MinorUnitMoney
`lines`必填ProfitBreakdownLine[]
`profit`必填MinorUnitMoney
`margin`必填number
`sizing`必填SizingDetail

curl -X POST \
  "/api/v3/gateway/amz_profit_calculate" \
  -H "Authorization: Bearer PASTE_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"costProfile":{"len1":20,"len2":12,"len3":5,"lenUnit":"cm","marketplace":"US","weight":0.45,"weightUnit":"kg","expectedAdsCostRatio":0.2,"expectedPurchasingCost":{"amount":{"value":3000},"currency":"CNY"},"expectedAverageDailyInventoryVolume":30,"expectedAverageDailyShippedVolume":3,"isApparel":false,"isDangerousGoods":false,"isBattery":false,"feeCategoryString":"HOME_AND_KITCHEN","exchangeRates":[{"currency":"USD","exchangeRate":{"value":100}},{"currency":"CNY","exchangeRate":{"value":720}},{"currency":"CAD","exchangeRate":{"value":136}},{"currency":"EUR","exchangeRate":{"value":92}},{"currency":"GBP","exchangeRate":{"value":79}},{"currency":"JPY","exchangeRate":{"value":15000}},{"currency":"MXN","exchangeRate":{"value":1700}},{"currency":"PLN","exchangeRate":{"value":400}},{"currency":"SEK","exchangeRate":{"value":1050}}],"price":{"amount":{"value":3999},"currency":"USD"}},"shippingProfile":{"exchangeRates":[{"currency":"USD","exchangeRate":{"value":100}},{"currency":"CNY","exchangeRate":{"value":720}},{"currency":"CAD","exchangeRate":{"value":136}},{"currency":"EUR","exchangeRate":{"value":92}},{"currency":"GBP","exchangeRate":{"value":79}},{"currency":"JPY","exchangeRate":{"value":15000}},{"currency":"MXN","exchangeRate":{"value":1700}},{"currency":"PLN","exchangeRate":{"value":400}},{"currency":"SEK","exchangeRate":{"value":1050}}],"freightPerKg":{"amount":{"value":3},"currency":"USD"},"airPerKg":{"amount":{"value":8},"currency":"USD"}}}'

对象

1031

接口请求和返回用到的对象。展开即可查看字段。

AbsencePolicy可选值 · 2

What an entity missing from a confirmed day means for its family.

可选值: ZERO_WHEN_COVEREDUNKNOWN

AbsoluteTargetBidValue2

An absolute bid for a keyword, a product target or an exact-harvest keyword.

`kind`可选string	可选值: `target_bid` 默认: `"target_bid"`
`bid`必填number \| string

AccountChoice2

One owner-visible account option offered when the caller must select an account.

`accountId`必填string	Stored account identifier.
`label`必填string	Readable account or marketplace name.

AccountRef4

One provider account reached through one bound connection.

`connectionId`必填string	Connector reaching this account.
`accountId`必填string	Account identifier within the source.
`timezone`必填string	Reporting timezone of this account.
`currency`可选string \| null	Account currency; null when no money is reported.

AcquisitionMode可选值 · 3

Whether DI may buy a bulk provider snapshot for this query, or only call live.

可选值: LIVESNAPSHOTPUBLIC_PAGE

ActionBatch1

One non-empty proposal batch with a unique caller-owned key for each action.

actions必填ProviderAction[]

Requested actions in order, each with a unique action_key.

ActionDiff11

One derived action diff with its declared undo fidelity and whether the row is revertible.

`actionKey`必填string	Proposal action row key.
`kind`必填ActionKind	ADD, SET or REMOVE action presentation kind.
`status`必填ActionStatus	Proposal preview or apply status for this row.
`target`必填EntityRef
`label`可选string \| null	Provider display label, when available.
`imageUrl`可选string \| null	The provider's https display image of the target, when it has one; display only, never identity; null when unknown.
`lines`可选DiffLine[]	Derived field-level change lines. 默认: `[]`
`fidelity`必填RevertFidelity	Declared completeness of the action's undo.
`revertible`可选boolean	Whether this row can be reverted: on a stored view, an applied, not yet reverted action whose fidelity is not NONE; on a preview, the declared limit. Never true when fidelity is NONE. 默认: `false`
`revertNote`可选StoreLocalizedText \| null	Provider-specific undo limitation, in both languages.
`alsoPending`可选string[]	Other open proposals touching the same change key. 默认: `[]`

ActionFamily2

One owner-facing group of actions that a store can enable or disable together.

`key`必填string	Write-family identifier.
`title`必填StoreLocalizedText	Owner-facing name of this write family.

ActionIntent可选值 · 5

Neutral write meanings, without provider wire names.

可选值: SET_BIDSET_STATESET_DAILY_BUDGETADD_KEYWORDADD_NEGATIVE_KEYWORD

ActionKind可选值 · 3

What one action does to its target; it selects the shared gate and diff colour.

可选值: SETADDREMOVE

ActionOutcome12

Live preview or final result for one action, with one typed refusal reason if rejected.

`actionKey`必填string	The action row this outcome belongs to.
`status`必填ActionStatus	Preview or apply result for this action.
`current`可选JsonValue \| null	Current provider value when available.
`label`可选string \| null	Provider label for the target, when available.
`created`可选EntityRef \| null
`issue`可选ProviderIssue \| null	Provider-owned refusal reason.
`refusal`可选string \| null	Why the write gate refused this row.
`blockedBy`可选string \| null	Earlier row or apply record holding a conflicting change key.
`problems`可选FieldProblem[]	Field-level provider validation details. 默认: `[]`
`quote`可选JsonValue \| null	Provider estimate included in this outcome.
`version`可选string \| null	Opaque live token read at preview.
`createdVersion`可选string \| null	Provider version of the entity an applied ADD created.

ActionProposal15

Stored proposal plus preview and eventual outcomes for one store and account.

`object`可选string	Fixed tag marking an action proposal. 可选值: `action_proposal` 默认: `"action_proposal"`
`proposalId`必填string	Identifier of this proposal.
`storeId`必填string	Store whose write policy applies.
`account`必填AccountRef	Account every action of this proposal targets.
`batch`必填ActionBatch	Requested provider changes.
`replayKey`可选string \| null	Caller-owned idempotency key.
`attribution`可选ProposalAttribution \| null	Origin and reason frozen at creation; null for 3.2 proposals; not hashed.
`decline`可选ProposalDecline \| null	Decline actor and reason; set exactly on a DECLINED proposal; not hashed.
`previews`必填ActionOutcome[]	One live outcome per action, in order.
`reverts`可选RevertLink[]	Apply records this proposal is attempting to revert. 默认: `[]`
`proposalHash`必填string	Hash of the exact proposal contents.
`proposedAt`必填string	Instant the proposal was created.
`expiresAt`必填string	Instant after which the proposal cannot be applied.
`state`可选ProposalState	Proposal lifecycle state. 默认: `"PROPOSED"`
`outcomes`可选ActionOutcome[]	One final outcome per action, set after proposal application. 默认: `[]`

ActionStatus可选值 · 5

Preview or apply result for one action; equality-to-preview is not a status.

可选值: ACCEPTEDAPPLIEDNO_CHANGEREJECTEDUNKNOWN

AddBlock4

Add one block (caller-chosen stable key) to a section after another block (None: at the end).

`action`可选string	可选值: `ADD_BLOCK` 默认: `"ADD_BLOCK"`
`sectionKey`必填string
`block`必填ThemeBlockInstance
`after`可选string \| null

AddDesign6

Add an empty OWN image; layouts come only from ApplyTemplate (one template path).

`action`可选string	可选值: `ADD_DESIGN` 默认: `"ADD_DESIGN"`
`designId`必填string
`name`必填string
`preset`必填string	可选值: `amazon.aplus.banneramazon.aplus.comparisonamazon.aplus.four_imageamazon.aplus.headeramazon.aplus.logoamazon.aplus.quadrantamazon.aplus.singleamazon.aplus_premium.full_widthamazon.brand_story.backgroundamazon.brand_story.cardamazon.mainamazon.secondarycustomshopify.blog_featuredshopify.collectionshopify.product`
`size`可选PixelSize \| null
`position`可选BoardPoint \| null

AddItems3

Add items by hand, as relevant; they start unplaced, so then CLASSIFY every dimension, price bands included.

`type`可选string	可选值: `ADD_ITEMS` 默认: `"ADD_ITEMS"`
`actionKey`必填string
`items`必填SourcedItem[]

AddLayer5

Insert a layer (caller-minted id) above above, or at the top when None.

`action`可选string	可选值: `ADD_LAYER` 默认: `"ADD_LAYER"`
`designId`必填string
`layer`必填ImageLayer \| TextLayer \| ShapeLayer \| GroupLayer
`above`可选string \| null
`parent`可选string \| null

AddNegativeKeywordValue2

The negative-keyword match type only; the text is the row's exact search term.

`kind`可选string	可选值: `negative_keyword` 默认: `"negative_keyword"`
`matchType`必填AdsNegativeMatch

AddPage4

Add an empty page for one template (UNKNOWN target refusals are the runtime's).

`action`可选string	可选值: `ADD_PAGE` 默认: `"ADD_PAGE"`
`template`必填ThemeTemplateRef
`previewPath`必填string
`newPage`可选NewKeblePage \| null

AddPlan7

Add a content plan whose rows will become variants of the OWN image source_id.

`action`可选string	可选值: `ADD_PLAN` 默认: `"ADD_PLAN"`
`objectId`必填string
`name`必填string
`sourceId`必填string
`columns`必填PlanColumn[]
`rows`可选PlanRow[]	默认: `[]`
`position`可选BoardPoint \| null

AddRows2

Append rows (create also uses this shape).

`op`可选string	可选值: `ADD_ROWS` 默认: `"ADD_ROWS"`
`rows`必填NewChangeRow[]

AddSection4

Place a new section (caller-chosen stable key) on a page after an anchor (None: at the end).

`action`可选string	可选值: `ADD_SECTION` 默认: `"ADD_SECTION"`
`page`必填ThemeTemplateRef
`section`必填ThemeSectionInstance
`after`可选string \| null

AdsAdType可选值 · 3

Amazon Ads product family one row belongs to (ELTA1 TodoAdType).

可选值: SPSBSD

AdsAdviceAction可选值 · 7

The one action the AI picks for one reviewed row (ELTA1 TodayAdviceAction).

可选值: LOWER_BIDNEGATEPAUSERAISE_BIDRAISE_BUDGETHARVEST_EXACTHOLD

AdsAdviceRow23

One flagged entity row of one marketplace, with its five windows.

`rowKey`必填string
`level`必填AdsLevel
`adType`必填AdsAdType
`entityId`必填string
`campaignId`可选string \| null
`adGroupId`可选string \| null
`keywordId`可选string \| null
`targetId`可选string \| null
`advertisedAsin`可选string \| null
`name`可选string \| null
`campaignName`可选string \| null
`adGroupName`可选string \| null
`state`可选string \| null
`budget`可选number \| string \| null
`matchType`可选AdsMatchType \| null
`bid`可选number \| string \| null
`d`必填AdsWindowMetrics
`dMinus1`必填AdsWindowMetrics
`dMinus7`必填AdsWindowMetrics
`l7`必填AdsWindowMetrics
`p7`必填AdsWindowMetrics
`triggerCodes`必填AdsTriggerCode[]
`foldedInto`可选string \| null

AdsChangeListAbsenceReason可选值 · 4

Why a marketplace that shows advice has no one-click AMZ_ADS_CHANGES list.

可选值: NO_ONE_CLICK_ROWSNO_ADS_ACCOUNTNOT_HOSTEDCREATE_FAILED

AdsDecisionType可选值 · 1

The Ads kind's one agent decision on the shared decision_type discriminator.

可选值: ADS_ROW_AUDIT

AdsEvidenceField可选值 · 8

The non-metric source facts of one AdsAdviceRow a citation may name.

可选值: namecampaign_namead_group_namestatebudgetbidtrigger_codesadvertised_asin

AdsEvidenceRole可选值 · 2

Whether one cited fact supports or cautions against the advice.

可选值: SUPPORTSCAUTION

AdsLevel可选值 · 6

Advice grain, mapped explicitly onto ELTA's EntityLevel.

可选值: CAMPAIGNAD_GROUPKEYWORDTARGETSEARCH_TERMADVERTISED_PRODUCT

AdsLevelNoChange3

Rows of one level that raised no signal: the proof of what was not shown.

`level`必填AdsLevel
`count`必填integer
`l7Spend`可选number \| string \| null

AdsMarketplaceAdvice12

The screen and review result of ONE marketplace of the store.

`marketplace`必填AmazonMarketplace
`currency`必填Currency
`anchorDay`必填string
`completeness`必填AdsWindowCompleteness
`screenedCount`必填integer
`candidateCount`必填integer
`candidateOverflow`可选boolean	默认: `false`
`noChange`可选AdsLevelNoChange[]	默认: `[]`
`rows`可选AdsAdviceRow[]	默认: `[]`
`reviews`可选AdsRowReview[]	默认: `[]`
`targetAcosPct`可选number \| string \| null
`oneClick`可选AdsRowOneClick[]	默认: `[]`

AdsMarketplaceQuery3

Ask for one marketplace's advice, optionally only the rows of one action.

`object`可选string	可选值: `ads_marketplace` 默认: `"ads_marketplace"`
`marketplace`必填AmazonMarketplace
`action`可选AdsAdviceAction \| null

AdsMatchType可选值 · 3

Keyword-only match identity from the existing ELTA datasets.

可选值: EXACTPHRASEBROAD

AdsMetricEvidenceRef5

Cite one measured cell of the reviewed row by window and metric.

`kind`可选string	可选值: `metric` 默认: `"metric"`
`rowKey`必填string
`window`必填AdsMetricWindow
`metric`必填AdsMetricName
`role`必填AdsEvidenceRole

AdsMetricName可选值 · 6

The AdsWindowMetrics fields a metric citation may name.

可选值: impressionsclicksspendorderssalesacos_pct

AdsMetricWindow可选值 · 5

The five metric-window fields of one AdsAdviceRow a citation may name.

可选值: dd_minus_1d_minus_7l7p7

AdsNegativeMatch可选值 · 2

The agent's negative-keyword match choice; mapped once to ELTA's type.

可选值: EXACTPHRASE

AdsReadOnlyReason可选值 · 5

Why one shown advice row has no one-click change.

可选值: NO_ELTA_ACTIONNOT_SPONSORED_PRODUCTSNO_VALUEASIN_TERMOVER_ROW_CAP

AdsReasoning3

Observation, inference and uncertainty as separate qualitative statements.

`observedSignal`必填string
`interpretation`必填string
`caveat`可选string \| null

AdsRowAuditAnswer3

One audit fragment: reviews for some offered rows plus the rows deliberately skipped.

`decisionType`可选string	可选值: `ADS_ROW_AUDIT` 默认: `"ADS_ROW_AUDIT"`
`reviews`可选AdsRowReview[]	默认: `[]`
`skippedRowKeys`可选string[]	默认: `[]`

AdsRowAuditItem4

One frozen flagged row offered to the agent, read in its marketplace's money.

`marketplace`必填AmazonMarketplace
`currency`必填Currency
`anchorDay`必填string
`row`必填AdsAdviceRow

AdsRowDetail5

One flagged row with its AI review and the money context it is read in.

`marketplace`必填AmazonMarketplace
`currency`必填Currency
`anchorDay`必填string
`row`必填AdsAdviceRow
`review`可选AdsRowReview \| null

AdsRowFieldEvidenceRef4

Cite one typed non-metric source fact of the reviewed row.

`kind`可选string	可选值: `row_field` 默认: `"row_field"`
`rowKey`必填string
`field`必填AdsEvidenceField
`role`必填AdsEvidenceRole

AdsRowOneClick3

Join one shown advice row to its change row, or state why it is read-only.

`rowKey`必填string
`changeRowKey`必填string \| null
`readOnly`必填AdsReadOnlyReason \| null

AdsRowQuery3

Ask for one flagged row of one marketplace and its AI review.

`object`可选string	可选值: `ads_row` 默认: `"ads_row"`
`marketplace`必填AmazonMarketplace
`rowKey`必填string

AdsRowReview6

One AI decision for one flagged row; the audit answer carries exactly these fields.

`rowKey`必填string
`action`必填AdsAdviceAction
`reason`必填string
`reasoning`可选AdsReasoning \| null
`evidenceRefs`可选AdsMetricEvidenceRef[] \| AdsRowFieldEvidenceRef[]	默认: `[]`
`suggestedChange`可选RelativeTargetBidChange \| AbsoluteTargetBidValue \| SetDailyBudgetValue \| AddNegativeKeywordValue \| null

AdsTriggerCode可选值 · 6

Deterministic screen signals (ELTA1 TodoTriggerCode).

可选值: SPEND_SPIKEZERO_ORDER_SPENDACOS_ABOVE_TARGETHARVEST_SEARCH_TERMSCALE_WINNERBUDGET_CAPPED

AdsWindowCompleteness5

Whether each comparison window of one marketplace is fully synced.

`latestDay`必填boolean
`previousDay`必填boolean
`sameWeekdayLastWeek`必填boolean
`last7Days`必填boolean
`prior7Days`必填boolean

AdsWindowMetrics6

Public metric bases and ACoS of one comparison window (ELTA1 DailyTodoWindowMetrics).

`impressions`可选number \| string \| null
`clicks`可选number \| string \| null
`spend`可选number \| string \| null
`orders`可选number \| string \| null
`sales`可选number \| string \| null
`acosPct`可选number \| string \| null

AlertCreate4

Immutable SYSTEM-only alert intent with an optional host-defined remedy.

`kind`可选string	可选值: `ALERT` 默认: `"ALERT"`
`content`必填ItemContent
`key`可选string \| null
`action`可选ItemAction \| null

AlertItem11

Source alert with immutable creation and source-confirmed clear state.

`id`必填string
`owner`必填OwnerRef
`current`必填ItemContent
`created_at`必填string
`revision`必填integer
`created_by`可选ActorRef \| null
`kind`可选string	可选值: `ALERT` 默认: `"ALERT"`
`object`可选string	可选值: `alert_item` 默认: `"alert_item"`
`creation`必填AlertCreate
`status`必填AlertStatus
`resolved_by`可选ActorRef \| null

AlertStatus可选值 · 2

An alert is cleared only after its source confirms recovery.

可选值: OPENCLEARED

AlignField2

Override value: a text layer's alignment.

`field`可选string	可选值: `ALIGN` 默认: `"ALIGN"`
`align`必填TextAlign

AmazonMarketplace可选值 · 13

可选值: USCAMXJPUKDEESFRITNLSEPLBE

AmzProfitCalculateRequest4

One product's cost and shipping observations for the profit calculator.

`costProfile`必填CostProfile
`shippingProfile`必填ShippingProfile
`shippingMode`可选ShippingMode	默认: `"FREIGHT"`
`isPeakPeriod`可选boolean	默认: `false`

Analysis8

Optional bounded analyzed facts (relations, unlinked mentions, concepts, trend features) attached to one typed node hit.

`recordKey`必填string	Analyzed record key these facts belong to.
`version`必填integer	Version of the analyzed record these facts were read from.
`observedAt`必填string \| null	When these facts were observed; null when unknown.
`freshness`可选RecordFreshnessTimes
`relations`可选RelationRef[]	Typed relations attached to the record. 默认: `[]`
`unlinkedMentions`可选UnlinkedMention[]	Claims of the record that name an entity no held record matched; at most 16. 默认: `[]`
`concepts`可选ConceptRef[]	Concepts extracted for the record. 默认: `[]`
`features`可选FeatureValue[]	Windowed feature values for the record. 默认: `[]`

AnalyzedRecordKind可选值 · 5

WHAT KIND OF RECORD a stored analyzed row is about — the column that makes 'kind is a column, not a table' true, and the identity space `AnalyzedStoreWriteProtocol.reserve_version` allocates versions in. NODE: one analyzed copy of any one node kind — a DI entity or content item or a DP-derived node; `node_kind` beside it says WHICH node. IDEA and CONCEPT: the extract capability's semantic output, including the CLAIM rows the grouping linker later matches. RELATION and TREND: what grouping computes — an edge between two nodes, and a windowed feature over such edges.

可选值: NODEIDEACONCEPTRELATIONTREND

AnalyzedRelationKind可选值 · 13

Every relation row the platform may write: subject --kind--> object.

可选值: VARIANT_OFBRANDED_BYSOLD_BYPUBLISHED_BYBELONGS_TO_CATEGORYSAME_PRODUCT_ASFEATURES_PRODUCTFEATURES_BRANDRANKED_FORMEMBER_OF_MOTIFPROMOTESSAME_CREATOR_ASCOMPETES_WITH

AnswerLanguage可选值 · 2

Language of seller-facing clarification and refusal wording.

可选值: ZHEN

ApplyTemplate4

Replace a design's layers with a template's, filling its placeholders (the one template path).

`action`可选string	可选值: `APPLY_TEMPLATE` 默认: `"APPLY_TEMPLATE"`
`designId`必填string
`template`必填string	可选值: `amazon.aplus.header.headlineamazon.main.packshotamazon.secondary.lifestyleamazon.secondary.three_calloutsshopify.blog_featured.headlineshopify.product.bold_dropshopify.product.packshot`
`fills`可选TextFill[] \| ImageFill[]	默认: `[]`

ApprovalCreate7

Immutable SYSTEM-written proposal intent, verified proposer and expiry.

`kind`可选string	可选值: `APPROVAL` 默认: `"APPROVAL"`
`content`必填ItemContent
`key`必填string
`proposal`必填ProposalRef
`requested_by`可选ActorRef \| null
`expires_at`可选string \| null
`ref`可选string \| null

ApprovalItem11

Proposal-bound decision whose source reference cannot be edited.

`id`必填string
`owner`必填OwnerRef
`current`必填ItemContent
`created_at`必填string
`revision`必填integer
`created_by`可选ActorRef \| null
`kind`可选string	可选值: `APPROVAL` 默认: `"APPROVAL"`
`object`可选string	可选值: `approval_item` 默认: `"approval_item"`
`creation`必填ApprovalCreate
`status`必填TodoApprovalStatus
`decided_by`可选ActorRef \| null

ApprovalState4

The live read of one filed item: inbox status and ELTA's current view.

`inboxItemId`必填string
`status`必填ArtifectHostApprovalStatus
`withdrawn`可选boolean	默认: `false`
`proposal`必填ProposalView

ApprovalView2

The inbox item and the proposal's current state shown to a person.

`item`必填ApprovalItem
`proposal`必填ProposalView

ApprovalViewRequest2

Select an approval by its existing item id or its proposal id.

`itemId`可选string \| null	Existing owner-scoped inbox item id.
`proposalId`可选string \| null	Proposal id, resolved through its owner-scoped inbox key.

ArtifectAccountRequired2

The create answer when the store has several accounts and none was chosen.

`object`可选string	可选值: `artifect_account_required` 默认: `"artifect_account_required"`
`accountChoices`必填AccountChoice[]

ArtifectAdjust3

Carry one post-completion adjustment against a committed revision.

`baseRevision`必填integer
`replayKey`必填string
`adjustment`必填ProfitInputsAdjustment \| ProfileInputsAdjustment \| ExcludeAsinsAdjustment \| JudgmentAdjustment \| ArtifectPositioningAdjustment \| ArtifectAdsAdviceRemove \| ArtifectProductImagesEdit \| ArtifectProductImagesExport \| ArtifectChangeListEdit \| ArtifectChangeListPropose \| ArtifectChangeListProposeRevert \| ArtifectShopifyThemeEdit \| ArtifectShopifyThemeUpdatePreview \| ArtifectShopifyThemePublish \| ArtifectShopifyThemeDiscardPreview \| ArtifectShopifyThemeProposeRevert \| ArtifectShopifyThemeProposeDiscard \| ArtifectShopifyBlogPostsEdits \| ArtifectShopifyBlogPostsPropose \| ArtifectShopifyBlogPostsProposeRevert \| ArtifectShopifyProductEdit \| ArtifectShopifyProductPropose \| ArtifectShopifyProductProposeRevert \| ArtifectAmzListingEdit \| ArtifectAmzListingPropose \| ArtifectAmzListingProposeRevert \| ArtifectFbaInboundProposePlan \| ArtifectFbaInboundProposePacking \| ArtifectFbaInboundProposeRevert \| ArtifectMonitorAdjust \| StandingAdjust	One post-completion edit. Later changes to the seller's own cost go through PROFILE_INPUTS and re-price every product; competitors' costs can be changed one by one or as a set through PROFIT_INPUTS. PROFILE_INPUTS also changes the ACOS band, the whole-product fixed size/weight and the entry budget; PROFIT_INPUTS corrects a named product (ask the seller for override sizes and weights; one size may be assigned to a set of products); EXCLUDE_ASINS never adds one. JUDGMENT rewrites the conclusion text of a finished revision (a verdict, named section slots or the overview; numbers untouched) and may be sent at any time. A re-priced revision carries a typed recheck hint: recheck the summary and conclusions against the new numbers, then send ONE JUDGMENT update. Conclusion texts carry no figures; a verdict the policy fixed (including a can't-decide NOT_DETERMINABLE) stays fixed and must be omitted.

ArtifectAdjustRequest2

Which run and typed adjustment; removed arms retain ordinary INVALID_REQUEST validation.

`ref`必填ArtifectRef
`adjust`必填ArtifectAdjust

ArtifectAdjustmentStatus8

Project one admitted adjustment or queued model work on the same run.

`adjustmentRef`必填string	Opaque child-task or same-run queued-work locator.
`stage`必填TaskStage	Adjustment or queued-work execution stage.
`targetRevision`必填integer	Revision the edit publishes or queued work updates.
`failureCode`可选string \| null	Stable child failure refinement code while failed, when available.
`failureReason`可选string \| null	Sanitized child failure sentence while failed.
`failureType`可选TaskExceptionType \| null	Child's keble-task failure class, set only while stage is FAILURE.
`updatedAt`必填string	Projection instant of this row.
`recheckHint`可选ArtifectRecheckHint \| null	Figures-moved recheck hint, set only on the SUCCESS projection of a committed adjustment whose figures moved; None (the default) is never serialized.

ArtifectAdsAdviceCreate5

Start one on-demand Ads optimization-suggestions run for one store.

`kind`可选string	可选值: `AMZ_ADS_ADVICE` 默认: `"AMZ_ADS_ADVICE"`
`replayKey`必填string
`storeId`必填string
`anchorDay`可选string \| null	Requested data day; null means yesterday in UTC; a later day is refused before any source is read.
`language`可选Language \| null

ArtifectAdsAdviceDetail2

Carry one marketplace's advice or one row's detail from the stored run.

`kind`可选string	可选值: `AMZ_ADS_ADVICE` 默认: `"AMZ_ADS_ADVICE"`
`answer`必填AdsMarketplaceAdvice \| AdsRowDetail

ArtifectAdsAdviceDetailQuery2

Wrap the ads-advice detail query (owned by ads_advice).

`kind`可选string	可选值: `AMZ_ADS_ADVICE` 默认: `"AMZ_ADS_ADVICE"`
`query`必填AdsMarketplaceQuery \| AdsRowQuery

ArtifectAdsAdviceRemove3

Remove advice rows in one marketplace, including manual-only advice.

`adjustmentType`可选string	可选值: `ADS_ADVICE_REMOVE` 默认: `"ADS_ADVICE_REMOVE"`
`marketplace`必填AmazonMarketplace
`rowKeys`必填string[]

ArtifectAdsAdviceSnapshot8

Expose one completed Ads optimization-suggestions run, per marketplace.

`kind`可选string	可选值: `AMZ_ADS_ADVICE` 默认: `"AMZ_ADS_ADVICE"`
`storeId`必填string
`createdAt`必填string
`requestedAnchorDay`可选string \| null
`marketplaces`可选AdsMarketplaceAdvice[]	默认: `[]`
`changeLists`可选ArtifectAdsChangeListLink[]	默认: `[]`
`changeListAbsences`可选ArtifectAdsChangeListAbsence[]	默认: `[]`
`unsupportedMarketplaces`可选string[]	默认: `[]`

ArtifectAdsChangeListAbsence2

Say why one marketplace that shows advice has no AMZ_ADS_CHANGES list.

`marketplace`必填AmazonMarketplace
`reason`必填AdsChangeListAbsenceReason

ArtifectAdsChangeListLink2

Link one marketplace of an Ads Advice run to its AMZ_ADS_CHANGES list.

`marketplace`必填AmazonMarketplace
`ref`必填ArtifectRef

ArtifectAdsRowAuditInputPage10

Input page for ADS_ROW_AUDIT: one page of flagged Ads rows to audit.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选AdsRowAuditItem[]	默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `ADS_ROW_AUDIT` 默认: `"ADS_ROW_AUDIT"`

ArtifectAmzListingCreate2

Create one owner-fenced new Amazon listing draft from the kind's own ListingCreate.

`kind`可选string	可选值: `AMZ_LISTING` 默认: `"AMZ_LISTING"`
`request`必填ListingCreate

ArtifectAmzListingEdit2

Replace an AMZ_LISTING draft's whole content (editor or agent edit).

`adjustmentType`可选string	可选值: `AMZ_LISTING_EDIT` 默认: `"AMZ_LISTING_EDIT"`
`content`必填ListingContent

ArtifectAmzListingPropose1

File the draft's one ADD for approval at the envelope's base_revision.

adjustmentType可选string

可选值: AMZ_LISTING_PROPOSE

默认: "AMZ_LISTING_PROPOSE"

ArtifectAmzListingProposeRevert1

File the undo (seller-SKU removal) of a LISTED draft at the envelope's base_revision.

adjustmentType可选string

可选值: AMZ_LISTING_PROPOSE_REVERT

默认: "AMZ_LISTING_PROPOSE_REVERT"

ArtifectAmzListingSnapshot2

Carry the listing core's current ListingSnapshot under its kind tag.

`kind`可选string	可选值: `AMZ_LISTING` 默认: `"AMZ_LISTING"`
`snapshot`必填ListingSnapshot

ArtifectAnswer4

Carry one validated decision fragment for a parked Artifect.

`inputKey`必填string
`expectedRevision`必填integer
`replayKey`必填string
`decision`必填ReportScopeAnswer \| SampleRelevanceAnswer \| MaterialFactsAnswer \| StandoutSelectionAnswer \| ReportJudgmentAnswer \| ArtifectPositioningStepDecision \| AdsRowAuditAnswer \| ArtifectShopifyBlogPostsStepDecision \| ArtifectMonitorSetupAnswer \| ArtifectMonitorConfirmAnswer

ArtifectAnswerRequest2

Which run, and the typed decision fragment (own input key, revision and replay_key).

`ref`必填ArtifectRef
`answer`必填ArtifectAnswer

ArtifectChangeListCreate2

Carry one account-free change-list create premise to its configured host.

`kind`必填string	可选值: `AMZ_LISTING_CHANGESSHOPIFY_ARTICLE_CHANGESSHOPIFY_SEO_CHANGESSHOPIFY_GEO_CHANGESAMZ_ADS_CHANGES`
`request`必填ChangeListCreatePremise

ArtifectChangeListEdit2

Submit the shared engine's typed edit operations through artifect_adjust.

`adjustmentType`可选string	可选值: `CHANGE_LIST_EDIT` 默认: `"CHANGE_LIST_EDIT"`
`ops`必填AddRows[] \| EditRow[] \| DiscardRow[] \| RestoreRow[]

ArtifectChangeListPropose2

Ask the shared engine to file selected rows; empty selects every eligible row.

`adjustmentType`可选string	可选值: `CHANGE_LIST_PROPOSE` 默认: `"CHANGE_LIST_PROPOSE"`
`rowKeys`可选string[]	默认: `[]`

ArtifectChangeListProposeRevert2

Ask the engine to revert selected applied rows; empty selects all eligible rows.

`adjustmentType`可选string	可选值: `CHANGE_LIST_PROPOSE_REVERT` 默认: `"CHANGE_LIST_PROPOSE_REVERT"`
`rowKeys`可选string[]	默认: `[]`

ArtifectChangeListSnapshot2

Carry the engine's canonical current change-list snapshot under its kind tag.

`kind`可选string	可选值: `AMZ_LISTING_CHANGESSHOPIFY_ARTICLE_CHANGESSHOPIFY_SEO_CHANGESSHOPIFY_GEO_CHANGESAMZ_ADS_CHANGESAMZ_MCF_ORDER` 默认: `"AMZ_LISTING_CHANGES"`
`snapshot`必填ChangeListSnapshot

ArtifectDecisionRejection8

Report one typed refusal without failing the Artifect run.

`object`可选string	可选值: `artifect_rejection` 默认: `"artifect_rejection"`
`inputKey`可选string \| null
`reason`必填ArtifectRejectionReason
`pendingInputKey`可选string \| null
`currentRevision`可选integer \| null
`itemKeys`可选string[] \| null
`message`可选string \| null
`kindCode`可选string \| null

ArtifectDescribeRequest1

Which kind's request bodies to describe.

kind必填string

Identify the workflow family handled by an Artifect runtime.

ArtifectDetail4

One typed detail answer about one artifect.

`object`可选string	可选值: `artifect_detail` 默认: `"artifect_detail"`
`ref`必填ArtifectRef
`payload`必填ArtifectReportDetail \| ArtifectPositioningDetail \| ArtifectAdsAdviceDetail \| ArtifectProductImagesDetail \| ArtifectShopifyThemeRunDetail \| ArtifectMonitorDetail \| ArtifectOccurrences
`capturedAt`必填string

ArtifectDetailRequest2

Address one artifect and ask it one kind-typed detail question.

`ref`必填ArtifectRef
`query`必填ArtifectReportDetailQuery \| ArtifectPositioningDetailQuery \| ArtifectAdsAdviceDetailQuery \| ArtifectProductImagesDetailQuery \| ArtifectShopifyThemeQuery \| ArtifectMonitorDetailQuery \| ArtifectOccurrencesQuery

ArtifectFailure4

The provider-free failure one customer answer may carry.

`object`可选string	可选值: `artifect_failure` 默认: `"artifect_failure"`
`code`必填ArtifectFailureCode
`retryable`必填boolean
`message`必填string

ArtifectFailureCode可选值 · 7

Classify one sanitized failure a customer may see for an Artifect run.

可选值: NOT_FOUNDINVALID_REQUESTCONFLICTRATE_LIMITEDQUOTA_EXHAUSTEDUNAVAILABLEINTERNAL

ArtifectFbaInboundPlanCreate5

Create one Amazon FBA inbound plan artifect and file its plan proposal.

`kind`可选string	可选值: `AMZ_FBA_INBOUND_PLAN` 默认: `"AMZ_FBA_INBOUND_PLAN"`
`replayKey`必填string
`storeId`必填string
`accountId`可选string \| null
`change`必填object	ELTA action `amazon.seller.create_fba_inbound_plan`'s change, passed through unchanged except for one default. Required: `source_address` (the private ship-from address, its `phone_number` included) and `items` (at least one row, each with `msku`, `quantity` > 0, `prep_owner` and `label_owner`). A row that omits `prep_owner` is filed with `SELLER`: Amazon refuses `NONE` for an item that needs prep, and Amazon US ended its own prep service on 2026-01-01, so `SELLER` is the safe choice there and `AMAZON` is never accepted for prep in the US. `name` is the plan's optional name. Full schema: elta_catalog actions[key=amazon.seller.create_fba_inbound_plan].changeSchema.

ArtifectFbaInboundPlanSnapshot9

Expose one FBA inbound plan: its stage, the agent's next step and the live approvals.

`kind`可选string	可选值: `AMZ_FBA_INBOUND_PLAN` 默认: `"AMZ_FBA_INBOUND_PLAN"`
`storeId`必填string
`stage`必填FbaInboundStage
`guide`必填string
`plan`可选EntityRef \| null
`planStatus`可选FbaInboundPlanStatus \| null
`create`可选ApprovalState \| null
`packing`可选ApprovalState \| null
`revert`可选ApprovalState \| null

ArtifectFbaInboundProposePacking2

File the boxes on the created plan with ELTA's SetFbaInboundPacking change.

adjustmentType可选string

可选值: AMZ_FBA_INBOUND_PLAN_PROPOSE_PACKING

默认: "AMZ_FBA_INBOUND_PLAN_PROPOSE_PACKING"

change必填object

ELTA action `amazon.seller.set_fba_inbound_packing`'s change, passed through unchanged and filed on the plan Amazon created. Required: `packing_option_id` (one of the plan's live packing options) and `groupings` (one per `packing_group_id`), each grouping holding its `boxes` - dimensions (length, width, height and unit), weight and weight_unit, the quantity of identical boxes - and the items in each box by `msku` and `quantity`. Full schema: elta_catalog actions[key=amazon.seller.set_fba_inbound_packing].changeSchema.

ArtifectFbaInboundProposePlan2

Re-file the plan with an edited ELTA CreateFbaInboundPlan change.

adjustmentType可选string

可选值: AMZ_FBA_INBOUND_PLAN_PROPOSE_PLAN

默认: "AMZ_FBA_INBOUND_PLAN_PROPOSE_PLAN"

change必填object

ELTA action `amazon.seller.create_fba_inbound_plan`'s change, passed through unchanged except for one default. Required: `source_address` (the private ship-from address, its `phone_number` included) and `items` (at least one row, each with `msku`, `quantity` > 0, `prep_owner` and `label_owner`). A row that omits `prep_owner` is filed with `SELLER`: Amazon refuses `NONE` for an item that needs prep, and Amazon US ended its own prep service on 2026-01-01, so `SELLER` is the safe choice there and `AMAZON` is never accepted for prep in the US. `name` is the plan's optional name. Full schema: elta_catalog actions[key=amazon.seller.create_fba_inbound_plan].changeSchema.

ArtifectFbaInboundProposeRevert1

File ELTA's undo of the newest applied proposal; undo cancels the whole plan.

adjustmentType可选string

可选值: AMZ_FBA_INBOUND_PLAN_PROPOSE_REVERT

默认: "AMZ_FBA_INBOUND_PLAN_PROPOSE_REVERT"

ArtifectInputRequest4

One page of the input a parked run offers.

`ref`必填ArtifectRef
`inputKey`必填string
`cursor`可选string \| null
`maxItems`可选integer \| null

ArtifectJudgmentInputPage16

Input page for JUDGMENT: the conclusion question and its citable evidence.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选ReportJudgmentEvidenceItem[]	Citable accepted artifacts. 默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `JUDGMENT` 默认: `"JUDGMENT"`
`language`必填Language	Reader language of every text.
`verdictOpen`必填boolean	False: a policy pre-check already fixed the verdict.
`fixedReasonCode`可选ReportReasonCode \| null	Set iff the verdict is not open.
`materialInputUnresolvedAdmissible`必填boolean	Whether MATERIAL_INPUT_UNRESOLVED may be the reason.
`ruleLines`可选string[]	Policy rules the verdict must follow. 默认: `[]`
`sectionKinds`必填ReportNarrativeSectionKind[]	The section slots to write, once each.

ArtifectKind可选值 · 16

Identify the workflow family handled by an Artifect runtime.

ArtifectKindDescription4

One hosted kind's label, purpose and exact request bodies as one JSON Schema document.

`kind`必填ArtifectKind
`label`必填string
`purpose`必填string
`requestSchema`必填object

ArtifectMaterialFactsInputPage10

Input page for MATERIAL_FACTS: every open material question.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选ReportMaterialQuestion[]	默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `MATERIAL_FACTS` 默认: `"MATERIAL_FACTS"`

ArtifectMonitorAdjust2

Edit a monitor's watches, schedule or delivery at the status's revision (0.25.0).

`adjustmentType`可选string	可选值: `MONITOR_ADJUST` 默认: `"MONITOR_ADJUST"`
`command`必填MonitorSetWatches \| MonitorSetCadence \| MonitorSetDelivery

ArtifectMonitorConfirmAnswer1

Confirm a MONITOR draft's spec at the answer's expected_revision (its spec revision, 0.25.0).

decisionType可选string

可选值: MONITOR_CONFIRM

默认: "MONITOR_CONFIRM"

ArtifectMonitorConfirmInputPage7

The MONITOR confirm page (0.25.0): "What we'll monitor" for the person to confirm.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`decisionType`可选string	可选值: `MONITOR_CONFIRM` 默认: `"MONITOR_CONFIRM"`
`inputKey`必填string
`ownerRevision`必填integer
`deadline`必填string
`nextCursor`可选null
`page`必填MonitorConfirmPage

ArtifectMonitorCreate3

Create one MONITOR draft (a standing artifect), parked on its setup input.

`kind`可选string	可选值: `MONITOR` 默认: `"MONITOR"`
`replayKey`必填string
`title`必填string

ArtifectMonitorDecisionType可选值 · 2

The two inputs a MONITOR draft parks on (0.25.0): setup, then the person's confirm.

可选值: MONITOR_SETUPMONITOR_CONFIRM

ArtifectMonitorDetail4

One monitor check in full (0.25.0), the answer to ArtifectMonitorDetailQuery.

`kind`可选string	可选值: `MONITOR` 默认: `"MONITOR"`
`cycle`必填MonitorCycle
`findings`可选MonitorFinding[]	默认: `[]`
`nextAfter`可选MonitorFindingKey \| null

ArtifectMonitorDetailQuery4

Open one monitor check in full (0.25.0): its coverage, deliveries and one findings page.

`kind`可选string	可选值: `MONITOR` 默认: `"MONITOR"`
`cycleSeq`必填integer
`after`可选MonitorFindingKey \| null
`limit`必填integer

ArtifectMonitorSetupAnswer4

Answer a MONITOR draft's setup: the watches, the schedule and the delivery channels (0.25.0).

`decisionType`可选string	可选值: `MONITOR_SETUP` 默认: `"MONITOR_SETUP"`
`watches`必填MonitorWatchRequest[]
`cadence`必填MonitorCadence
`delivery`可选MonitorDelivery	默认: `{"chat":true,"email":false}`

ArtifectMonitorSetupInputPage7

The MONITOR setup page (0.25.0): the core-rendered capability offers and the cadence floor.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`decisionType`可选string	可选值: `MONITOR_SETUP` 默认: `"MONITOR_SETUP"`
`inputKey`必填string
`ownerRevision`必填integer
`deadline`必填string
`nextCursor`可选null
`page`必填MonitorSetupPage

ArtifectMonitorSnapshot2

A MONITOR's snapshot (0.25.0): the monitor, its open cycle and its newest finished one.

`kind`可选string	可选值: `MONITOR` 默认: `"MONITOR"`
`snapshot`必填MonitorSnapshot

ArtifectOccurrence5

One scheduled occurrence (a monitor's check), as every standing kind shows it.

`seq`必填integer
`state`必填ArtifectOccurrenceState
`dueAt`必填string
`finishedAt`必填string \| null
`newCount`必填integer

ArtifectOccurrenceState可选值 · 5

Where one scheduled occurrence is; RUNNING is open, the other four are finished.

可选值: RUNNINGREPORTEDQUIETSKIPPEDFAILED

ArtifectOccurrences2

The answer to ArtifectOccurrencesQuery: one page of occurrences, newest first.

`items`必填ArtifectOccurrence[]
`more`必填boolean

ArtifectOccurrencesQuery4

List a standing artifect's occurrences (a monitor's checks), newest first.

`query`必填string	可选值: `OCCURRENCES`
`beforeSeq`可选integer \| null
`limit`必填integer
`kind`可选string \| null

ArtifectPendingInput5

Summarize the one request a WAITING_FOR_INPUT Artifect is parked on.

`inputKey`必填string
`decisionType`必填ReportDecisionType \| ArtifectPositioningDecisionType \| AdsDecisionType \| ArtifectShopifyBlogPostsDecisionType \| ArtifectMonitorDecisionType
`itemCount`必填integer
`coveredItemCount`必填integer
`deadline`必填string

ArtifectPositioningAdjustment2

Post-completion positioning edits applied literally, without a rerun.

`adjustmentType`可选string	可选值: `POSITIONING_EDITS` 默认: `"POSITIONING_EDITS"`
`edits`必填SetSetup[] \| AddItems[] \| UpdateItems[] \| RemoveItems[] \| SaveDimension[] \| DeleteDimension[] \| SetPlacements[] \| SaveCriterion[] \| DeleteCriterion[] \| SetResults[] \| SaveView[] \| DeleteView[] \| ReorderViews[] \| Continue[] \| SetReview[] \| Cancel[] \| Propose[] \| Classify[] \| Assess[] \| Score[] \| Decide[]

ArtifectPositioningCreate6

Carry the source-agnostic premise for one positioning study.

`kind`可选string	可选值: `POSITIONING` 默认: `"POSITIONING"`
`replayKey`必填string
`positioningContext`必填string
`pluginId`可选string \| null	Installed plugin ID; omit for the host default. Setup must match this plugin's declaration.
`setup`可选object \| null	Values for the selected plugin's declared setup fields; omitted fields are proposed at SCOPE.
`language`可选Language \| null

ArtifectPositioningDecisionType可选值 · 1

The one positioning answer family: a waiting run step's reviewed result.

可选值: POSITIONING_STEP

ArtifectPositioningDetail2

Carry positioning's own answered detail and the labels its answer uses.

`kind`可选string	可选值: `POSITIONING` 默认: `"POSITIONING"`
`answer`必填PositioningDetail

ArtifectPositioningDetailQuery2

Wrap the POSITIONING package's own detail query for one positioning.

`kind`可选string	可选值: `POSITIONING` 默认: `"POSITIONING"`
`query`必填PositioningCellQuery \| PositioningItemsQuery

ArtifectPositioningSnapshot3

Expose one committed POSITIONING revision through customer projections.

`kind`可选string	可选值: `POSITIONING` 默认: `"POSITIONING"`
`room`必填RoomPublicRead
`decision`必填RoomPublicDecisionRead

ArtifectPositioningStepCell2

One assessed cell the waiting step produced (the ASSESS review).

`resultType`可选string	可选值: `CELL` 默认: `"CELL"`
`cell`必填RoomCell

ArtifectPositioningStepDecision3

Answer a waiting positioning step: apply these edits, then continue.

`decisionType`可选string	可选值: `POSITIONING_STEP` 默认: `"POSITIONING_STEP"`
`step`必填RunStep
`edits`可选SetSetup[] \| AddItems[] \| UpdateItems[] \| RemoveItems[] \| SaveDimension[] \| DeleteDimension[] \| SetPlacements[] \| SaveCriterion[] \| DeleteCriterion[] \| SetResults[] \| SaveView[] \| DeleteView[] \| ReorderViews[] \| Continue[] \| SetReview[] \| Cancel[] \| Propose[] \| Classify[] \| Assess[] \| Score[] \| Decide[]	默认: `[]`

ArtifectPositioningStepInputPage8

One waiting positioning step and the result its agent reviews.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`decisionType`可选string	可选值: `POSITIONING_STEP` 默认: `"POSITIONING_STEP"`
`inputKey`必填string
`step`必填RunStep
`run`必填RunRead
`results`可选ArtifectPositioningStepItem[] \| ArtifectPositioningStepCell[]	默认: `[]`
`nextCursor`可选string \| null
`deadline`必填string

ArtifectPositioningStepItem2

One sourced or placed item the waiting step produced (the SOURCE/PLACE review).

`resultType`可选string	可选值: `ITEM` 默认: `"ITEM"`
`item`必填ItemRead

ArtifectProductImagesCreate2

Create one product-image set from photos already uploaded through the image artifect.

`kind`可选string	可选值: `PRODUCT_IMAGES` 默认: `"PRODUCT_IMAGES"`
`request`必填CreateImageSet

ArtifectProductImagesDetail3

Carry the board's EXPORTS view and ephemeral links for its newest export.

`kind`可选string	可选值: `PRODUCT_IMAGES` 默认: `"PRODUCT_IMAGES"`
`exports`可选ExportSet[]	默认: `[]`
`newestUrls`可选HostedImage[]	默认: `[]`

ArtifectProductImagesDetailQuery2

Ask one image set one detail view.

`kind`可选string	可选值: `PRODUCT_IMAGES` 默认: `"PRODUCT_IMAGES"`
`view`必填ProductImagesDetailView

ArtifectProductImagesEdit3

Edit or quote one board using the image contract's own action batch.

`adjustmentType`可选string	可选值: `PRODUCT_IMAGES_EDIT` 默认: `"PRODUCT_IMAGES_EDIT"`
`actions`必填AddDesign[] \| RemoveDesign[] \| OrderDesigns[] \| ResizeDesign[] \| SetBackground[] \| ApplyTemplate[] \| AddLayer[] \| RemoveLayers[] \| OrderLayer[] \| SetBox[] \| SetLayerFlags[] \| SetText[] \| SetTextStyle[] \| SetShapeStyle[] \| SetShadow[] \| GroupLayers[] \| UngroupLayer[] \| CutOutProduct[] \| GenerateScene[] \| RestoreRevision[] \| SetObjectFrame[] \| SetObjectLock[] \| CreateVariants[] \| SetVariantRecipe[] \| DetachVariant[] \| AddPlan[] \| SetPlan[] \| GenerateFromPlan[] \| PlaceBrandKit[] \| SetImageTransform[] \| GenerateDecor[] \| SetBoardTitle[]
`dryRun`可选boolean	默认: `false`

ArtifectProductImagesExport3

Export one revision of an image set (head when revision is None).

`adjustmentType`可选string	可选值: `PRODUCT_IMAGES_EXPORT` 默认: `"PRODUCT_IMAGES_EXPORT"`
`revision`可选integer \| null
`options`可选ExportOptions

ArtifectProductImagesQuote2

The no-write quote returned only by a product-images dry-run adjustment.

`object`可选string	可选值: `artifect_quote` 默认: `"artifect_quote"`
`quote`必填BatchQuote

ArtifectProductImagesSnapshot2

Expose the image contract's canonical multi-object board outline.

`kind`可选string	可选值: `PRODUCT_IMAGES` 默认: `"PRODUCT_IMAGES"`
`outline`必填DocumentOutline

ArtifectRecheckHint2

Tell the agent which snapshot parts moved and how to recheck them.

`partKeys`必填string[]	Affected snapshot parts using the owning kind's existing stable keys, converted by its adapter. Never displayed.
`message`必填string	Owner-authored, number-free recheck sentence shown to the reader.

ArtifectRef2

Identify one durable Artifect instance by its opaque public id.

`object`可选string	可选值: `artifect_ref` 默认: `"artifect_ref"`
`id`必填string

ArtifectRejectionReason可选值 · 11

Why an answer or adjustment was refused with state left unchanged.

可选值: STALE_REVISIONWRONG_INPUTUNKNOWN_ITEMITEM_ALREADY_ANSWEREDCONFLICTNOT_IN_SAMPLEEVIDENCE_NOT_RETAINEDREVISION_CONFLICTRUN_TERMINALINVALID_EVIDENCEINVALID_VALUE

ArtifectReportCreate12

Carry the complete V3 report premise accepted by the runtime.

`kind`可选string	可选值: `AMZ_PRODUCT_REPORT` 默认: `"AMZ_PRODUCT_REPORT"`
`replayKey`必填string
`asin`必填string
`amazonMarketplace`必填AmazonMarketplace
`keywords`可选string[]	Discovery keywords; suggest keywords, the seller confirms; at least one nonblank keyword with categoryId skips REPORT_SCOPE; otherwise the run parks on REPORT_SCOPE to ask. 默认: `[]`
`categoryId`可选integer \| null	Confirmed Amazon category; with at least one nonblank keyword it skips REPORT_SCOPE.
`title`可选string \| null
`image`可选string \| null
`language`可选Language \| null
`similarProductsLimit`可选integer \| null	How many comparable products to analyse; None keeps the runtime's website-aligned default.
`economicSetup`可选ReportProfileEconomicFields \| null	The seller's economic setup in the report package's own field names (ACOS band, fixed size/weight, entry-budget threshold). Its suggestedPurchasingCost is refused when purchaseCost is sent, so the seller's cost has ONE create source; a later PROFILE_INPUTS edit changes the benchmark, never a PROFIT_INPUTS override of the analysed product.
`purchaseCost`必填ArtifectReportUserPurchaseCost \| ArtifectReportSystemEstimatedPurchaseCost	Required seller-confirmed cost: show Keble's estimate as a suggestion, confirm the cost (single or range) with the seller before creating; later changes to the seller's own cost go through PROFILE_INPUTS and re-price every product; competitors' costs can be changed one by one or as a set through PROFIT_INPUTS.

ArtifectReportDetail2

Carry the report package's own typed detail answer.

`kind`可选string	可选值: `AMZ_PRODUCT_REPORT` 默认: `"AMZ_PRODUCT_REPORT"`
`answer`必填ReportV3OverviewToolResult \| ReportV3ListingsToolResult \| ReportV3ListingDetailToolResult \| ReportV3SectionToolResult \| ReportV3ConclusionToolResult \| ReportV3LifecycleToolResult \| ReportV3EstimationToolResult \| ReportV3JudgmentToolResult

ArtifectReportDetailQuery2

Wrap the REPORT package's own detail query for one report artifect.

`kind`可选string	可选值: `AMZ_PRODUCT_REPORT` 默认: `"AMZ_PRODUCT_REPORT"`
`query`必填ReportOverviewQuery \| ReportListingsQuery \| ReportListingQuery \| ReportSectionQuery \| ReportEvidenceQuery \| ReportJudgmentQuery

ArtifectReportScopeInputPage10

Input page for REPORT_SCOPE: the offered category candidates.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选ReportScopeCandidate[]	默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `REPORT_SCOPE` 默认: `"REPORT_SCOPE"`

ArtifectReportSnapshot2

Expose one immutable progressive REPORT snapshot from report CRUD.

`kind`可选string	可选值: `AMZ_PRODUCT_REPORT` 默认: `"AMZ_PRODUCT_REPORT"`
`payload`必填ProgressiveReportSnapshot

ArtifectReportSystemEstimatedPurchaseCost2

Carry the seller's explicit agreement to let Keble estimate the cost.

`source`可选string	可选值: `SYSTEM_ESTIMATED` 默认: `"SYSTEM_ESTIMATED"`
`sellerAgreed`必填boolean	The seller agreed to use Keble's estimate; must be true. A create never assumes this agreement. 可选值: `true`

ArtifectReportUserPurchaseCost3

Carry the seller's own purchasing cost, as one value or a low/high range.

`source`可选string	可选值: `USER_SUPPLIED` 默认: `"USER_SUPPLIED"`
`value`必填MinorUnitMoney	The seller's own per-unit purchasing cost.
`upperBound`可选MinorUnitMoney \| null	Range upper bound; omit it for a single value. When present it must use the same currency as value and be >= value.

ArtifectRunItem11

One run the caller's owner started, from any starter (web, agent, MCP).

`ref`必填ArtifectRef
`kind`必填ArtifectKind
`stage`必填TaskStage
`failureType`可选TaskExceptionType \| null	Task failure class, set only while the run has failed.
`failureCode`可选string \| null	Stable failure refinement code for classification only; user interfaces map it to copy.
`title`必填string \| null
`storeId`必填string \| null
`anchorDay`必填string \| null
`createdAt`必填string
`completedAt`可选string \| null	When the run's task reached SUCCESS or FAILURE (its success_ts/failure_ts); null otherwise.
`changeListStage`可选ChangeListStage \| null

ArtifectRunList3

One newest-first page; next_before is set only when an older run exists.

`object`可选string	可选值: `artifect_run_list` 默认: `"artifect_run_list"`
`runs`必填ArtifectRunItem[]
`nextBefore`可选string \| null

ArtifectRunsRequest4

Which of the caller's own Artifect runs to list, newest first.

`kind`可选ArtifectKind \| null
`storeId`可选string \| null
`limit`可选integer	默认: `5`
`before`可选string \| null

ArtifectSampleRelevanceInputPage10

Input page for SAMPLE_RELEVANCE: one page of frozen candidates.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选SampleRelevanceItem[]	默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `SAMPLE_RELEVANCE` 默认: `"SAMPLE_RELEVANCE"`

ArtifectShopifyBlogPostsCreate2

Create one guided Shopify blog post set from the kind's own BlogCreate.

`kind`可选string	可选值: `SHOPIFY_BLOG_POSTS` 默认: `"SHOPIFY_BLOG_POSTS"`
`request`必填BlogCreate

ArtifectShopifyBlogPostsDecisionType可选值 · 1

The one blog-posts answer family: the parked guided step's answer.

可选值: SHOPIFY_BLOG_POSTS_STEP

ArtifectShopifyBlogPostsEdits2

Edit a READY blog post set before create-all: replace or drop posts.

`adjustmentType`可选string	可选值: `SHOPIFY_BLOG_POSTS_EDITS` 默认: `"SHOPIFY_BLOG_POSTS_EDITS"`
`edits`必填ReplacePost[] \| DropPost[]

ArtifectShopifyBlogPostsPropose1

File create-all for the READY post set at the envelope's base_revision.

adjustmentType可选string

可选值: SHOPIFY_BLOG_POSTS_PROPOSE

默认: "SHOPIFY_BLOG_POSTS_PROPOSE"

ArtifectShopifyBlogPostsProposeRevert1

File revert-all of the applied create-all's still-live articles at base_revision.

adjustmentType可选string

可选值: SHOPIFY_BLOG_POSTS_PROPOSE_REVERT

默认: "SHOPIFY_BLOG_POSTS_PROPOSE_REVERT"

ArtifectShopifyBlogPostsSnapshot2

Carry the blog-posts kind's revisioned BlogSnapshot under its kind tag, minus its staged batch.

`kind`可选string	可选值: `SHOPIFY_BLOG_POSTS` 默认: `"SHOPIFY_BLOG_POSTS"`
`snapshot`必填BlogSnapshot

ArtifectShopifyBlogPostsStepDecision2

Answer the parked guided blog step with that step's own answer model.

`decisionType`可选string	可选值: `SHOPIFY_BLOG_POSTS_STEP` 默认: `"SHOPIFY_BLOG_POSTS_STEP"`
`answer`必填BlogDirection \| PostPlan \| StyleExamples \| PostDraft \| PostSelfReview \| SampleConfirmation

ArtifectShopifyBlogPostsStepInputPage11

Input page of the parked guided blog step: its guidance and the posts still uncovered.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选PlannedPost[]	默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `SHOPIFY_BLOG_POSTS_STEP` 默认: `"SHOPIFY_BLOG_POSTS_STEP"`
`step`必填BlogStep

ArtifectShopifyProductCreate2

Create one unpublished Shopify product draft from the kind's ProductCreateRequest.

`kind`可选string	可选值: `SHOPIFY_PRODUCT` 默认: `"SHOPIFY_PRODUCT"`
`request`必填ProductCreateRequest

ArtifectShopifyProductEdit2

Replace a Shopify product draft's whole content (pane or agent edit).

`adjustmentType`可选string	可选值: `SHOPIFY_PRODUCT_EDIT` 默认: `"SHOPIFY_PRODUCT_EDIT"`
`content`必填ProductContent

ArtifectShopifyProductPropose1

File the draft's one product.create at the envelope's base_revision.

adjustmentType可选string

可选值: SHOPIFY_PRODUCT_PROPOSE

默认: "SHOPIFY_PRODUCT_PROPOSE"

ArtifectShopifyProductProposeRevert1

File one product.delete for the run's single live product, at base_revision.

adjustmentType可选string

可选值: SHOPIFY_PRODUCT_PROPOSE_REVERT

默认: "SHOPIFY_PRODUCT_PROPOSE_REVERT"

ArtifectShopifyProductSnapshot2

Carry the product kind's revisioned ProductSnapshot under its kind tag, minus its staged batch.

`kind`可选string	可选值: `SHOPIFY_PRODUCT` 默认: `"SHOPIFY_PRODUCT"`
`snapshot`必填ProductSnapshot

ArtifectShopifyThemeCreate2

Create one Shopify theme document workspace from the theme contract's document request.

kind可选string

可选值: SHOPIFY_THEME_UPDATE

默认: "SHOPIFY_THEME_UPDATE"

request必填ThemeDocumentCreateRequest

ArtifectShopifyThemeDetail3

Legacy change-set runs only: carry the run's typed change-set detail unchanged.

`kind`可选string	可选值: `SHOPIFY_THEME_UPDATE` 默认: `"SHOPIFY_THEME_UPDATE"`
`changeSet`必填ThemeChangeSet
`proposalStates`可选ThemeProposalStateRead[]	默认: `[]`

ArtifectShopifyThemeDetailQuery2

Legacy change-set runs only: address one change set of the run for a detail read.

`kind`可选string	可选值: `SHOPIFY_THEME_UPDATE` 默认: `"SHOPIFY_THEME_UPDATE"`
`changeSetId`必填string

ArtifectShopifyThemeDiscardPreview1

File the delete of the run's one preview copy (explicit only; abandonment never discards).

adjustmentType可选string

可选值: SHOPIFY_THEME_UPDATE_DISCARD_PREVIEW

默认: "SHOPIFY_THEME_UPDATE_DISCARD_PREVIEW"

ArtifectShopifyThemeDocumentDetail3

Carry one detail answer of a theme DOCUMENT run (the report/positioning nested-answer pattern).

`kind`可选string	可选值: `SHOPIFY_THEME_UPDATE` 默认: `"SHOPIFY_THEME_UPDATE"`
`runKind`可选string	可选值: `DOCUMENT` 默认: `"DOCUMENT"`
`answer`必填ArtifectShopifyThemeRevisionAnswer \| ArtifectShopifyThemeTemplatesAnswer \| ArtifectShopifyThemeTemplateOutlineAnswer

ArtifectShopifyThemeDocumentQuery3

Address one detail view of a theme DOCUMENT run (the report/positioning nested-query pattern).

`kind`可选string	可选值: `SHOPIFY_THEME_UPDATE` 默认: `"SHOPIFY_THEME_UPDATE"`
`runKind`必填string	可选值: `DOCUMENT`
`query`必填ArtifectShopifyThemeRevisionQuery \| ArtifectShopifyThemeTemplatesQuery \| ArtifectShopifyThemeTemplateOutlineQuery

ArtifectShopifyThemeDocumentSnapshot4

Expose a theme DOCUMENT run's snapshot: the theme contract's document snapshot plus live states.

`kind`可选string	可选值: `SHOPIFY_THEME_UPDATE` 默认: `"SHOPIFY_THEME_UPDATE"`
`runKind`可选string	可选值: `DOCUMENT` 默认: `"DOCUMENT"`
`snapshot`必填ThemeDocumentSnapshot
`proposalStates`可选ThemeDocumentProposalStateRead[]	默认: `[]`

ArtifectShopifyThemeEdit2

Edit one theme document: the theme contract's own typed page actions, applied as one batch.

adjustmentType可选string

可选值: SHOPIFY_THEME_UPDATE_EDIT

默认: "SHOPIFY_THEME_UPDATE_EDIT"

Typed page edits committed together as the next revision, or not at all. Pages are JSON templates (INDEX, PRODUCT, COLLECTION, PAGE, BLOG, ARTICLE); a new Keble landing page uses PAGE with a keble- suffix. Section kinds and settings (type, bound): HERO_BANNER: heading TEXT max 120, subheading TEXT max 250, image IMAGE_URL max 2048, button_label TEXT max 40, button_link URL max 2048, alignment SELECT left|center|right, overlay_opacity RANGE 0-90 step 10, text_color COLOR #rrggbb | RICH_TEXT: heading TEXT max 120, text RICHTEXT max 5000 (plain text, no HTML; a blank line starts a paragraph), alignment SELECT left|center|right, text_color COLOR #rrggbb | IMAGE_WITH_TEXT: image IMAGE_URL max 2048, image_position SELECT left|right, heading TEXT max 120, text RICHTEXT max 2000 (plain text, no HTML; a blank line starts a paragraph), button_label TEXT max 40, button_link URL max 2048, text_color COLOR #rrggbb | FAQ: heading TEXT max 120, text_color COLOR #rrggbb; blocks QUESTION up to 20 (question TEXT max 250, answer RICHTEXT max 2000 (plain text, no HTML; a blank line starts a paragraph)) | FEATURE_LIST: heading TEXT max 120, columns RANGE 2-4 step 1, text_color COLOR #rrggbb; blocks FEATURE up to 12 (title TEXT max 80, text RICHTEXT max 500 (plain text, no HTML; a blank line starts a paragraph), image IMAGE_URL max 2048). Section keys start with keble- and are unique in the document; unset settings inherit the theme, and a null setting value unsets it again. after names the template entry a section follows (entry ids from the TEMPLATE_OUTLINE detail view): "@start" places it first, omitting after places it last. RESTORE_REVISION is the only action of its batch. A page must be in the document before its sections: send ADD_PAGE for the template first, in the same batch or an earlier one (INDEX uses previewPath "/").

ArtifectShopifyThemeProposeDiscard2

Legacy change-set runs only: propose deleting one rejected change set's ELTA-created preview copy.

`adjustmentType`可选string	可选值: `SHOPIFY_THEME_UPDATE_PROPOSE_DISCARD` 默认: `"SHOPIFY_THEME_UPDATE_PROPOSE_DISCARD"`
`changeSetId`必填string

ArtifectShopifyThemeProposeRevert2

Legacy change-set runs only: propose ELTA's undo of one accepted change set.

`adjustmentType`可选string	可选值: `SHOPIFY_THEME_UPDATE_PROPOSE_REVERT` 默认: `"SHOPIFY_THEME_UPDATE_PROPOSE_REVERT"`
`changeSetId`必填string

ArtifectShopifyThemePublish2

File one publish of a document revision onto the run's target theme.

adjustmentType可选string

可选值: SHOPIFY_THEME_UPDATE_PUBLISH

默认: "SHOPIFY_THEME_UPDATE_PUBLISH"

revision可选integer | null

The revision to publish to the target theme; null publishes the head revision, resolved before filing. Publishing applies to the store now. To undo, publish the previously published revision (revision 0 is the empty starting version, so publishing it undoes a first publish): it removes only Keble's placement, so the page is restored and Keble section files stay in the theme, unused. A publish also deletes the preview copy when the copy holds the published revision. While one publish applies, publishing another revision is refused PROPOSAL_PENDING (publishing the same revision again answers the pending publish); NOTHING_TO_PROPOSE means the theme already shows that revision.

ArtifectShopifyThemeQuery以下之一 · 2

以下之一: ArtifectShopifyThemeDetailQuery | ArtifectShopifyThemeDocumentQuery

ArtifectShopifyThemeRevisionAnswer2

Answer the REVISION view: one committed revision of a theme DOCUMENT run, unchanged.

`view`可选string	可选值: `REVISION` 默认: `"REVISION"`
`revision`必填ThemeRevision

ArtifectShopifyThemeRevisionQuery2

Ask a theme DOCUMENT run for one committed revision (the REVISION(n) view).

`view`可选string	可选值: `REVISION` 默认: `"REVISION"`
`revision`必填integer

ArtifectShopifyThemeRunDetail以下之一 · 2

以下之一: ArtifectShopifyThemeDetail | ArtifectShopifyThemeDocumentDetail

ArtifectShopifyThemeRunSnapshot以下之一 · 2

以下之一: ArtifectShopifyThemeSnapshot | ArtifectShopifyThemeDocumentSnapshot

ArtifectShopifyThemeSnapshot4

Legacy change-set runs only: the run's snapshot, its create ledger beside the target theme.

`kind`可选string	可选值: `SHOPIFY_THEME_UPDATE` 默认: `"SHOPIFY_THEME_UPDATE"`
`ledger`必填ThemeCreateLedger
`targetTheme`可选ThemeRef \| null
`proposalStates`可选ThemeProposalStateRead[]	默认: `[]`

ArtifectShopifyThemeTemplateOutlineAnswer3

Answer the TEMPLATE_OUTLINE view: one template's merchant entries in order (this run's excluded).

`view`可选string	可选值: `TEMPLATE_OUTLINE` 默认: `"TEMPLATE_OUTLINE"`
`source`必填ThemeFrameSource
`outline`必填ThemeTemplateOutline

ArtifectShopifyThemeTemplateOutlineQuery3

Ask a theme DOCUMENT run for one template's merchant entries in order (the locked tree, anchors).

`view`可选string	可选值: `TEMPLATE_OUTLINE` 默认: `"TEMPLATE_OUTLINE"`
`template`必填ThemeTemplateRef
`source`可选ThemeFrameSource	默认: `"TARGET"`

ArtifectShopifyThemeTemplatesAnswer3

Answer the TEMPLATES view: the placeable JSON page templates the read theme has now.

`view`可选string	可选值: `TEMPLATES` 默认: `"TEMPLATES"`
`source`必填ThemeFrameSource
`templates`可选ThemeTemplateRef[]	默认: `[]`

ArtifectShopifyThemeTemplatesQuery2

Ask a theme DOCUMENT run which JSON page templates its target (or copy) has now (the page picker).

`view`可选string	可选值: `TEMPLATES` 默认: `"TEMPLATES"`
`source`可选ThemeFrameSource	默认: `"TARGET"`

ArtifectShopifyThemeUpdatePreview1

File one step toward the run's preview copy holding the head revision; it waits in To do for a person.

adjustmentType可选string

可选值: SHOPIFY_THEME_UPDATE_UPDATE_PREVIEW

默认: "SHOPIFY_THEME_UPDATE_UPDATE_PREVIEW"

ArtifectSnapshot4

Expose one immutable domain snapshot and optional ephemeral image parts.

`object`可选string	可选值: `artifect_snapshot` 默认: `"artifect_snapshot"`
`ref`必填ArtifectRef
`payload`必填ArtifectReportSnapshot \| ArtifectPositioningSnapshot \| ArtifectAdsAdviceSnapshot \| ArtifectProductImagesSnapshot \| ArtifectShopifyThemeRunSnapshot \| ArtifectChangeListSnapshot \| ArtifectShopifyBlogPostsSnapshot \| ArtifectShopifyProductSnapshot \| ArtifectAmzListingSnapshot \| ArtifectFbaInboundPlanSnapshot \| ArtifectMonitorSnapshot
`capturedAt`必填string

ArtifectSnapshotRequest3

Which run, which immutable revision (None is the head) and which board objects to focus.

`ref`必填ArtifectRef
`revision`可选integer \| null
`focus`可选string[]	默认: `[]`

ArtifectStanding6

The long-lived part of one status (ArtifectStatus.standing); set exactly for STANDING kinds.

`state`必填StandingState
`pausedBy`必填StandingPauseBy \| null
`pause`必填ArtifectStandingPause \| null
`nextRunAt`必填string \| null
`openOccurrence`必填ArtifectStandingOccurrence \| null
`lastOccurrence`必填ArtifectStandingOccurrence \| null

ArtifectStandingOccurrence2

One occurrence of a standing run as its status shows it: its sequence and where it is.

`seq`必填integer
`state`必填ArtifectOccurrenceState

ArtifectStandingPause2

The stored cause of a standing run's pause by core's gate or by its kind.

`code`必填string \| null
`message`必填string

ArtifectStandoutInputPage10

Input page for STANDOUT_SELECTION: the built cohort to choose from.

`object`可选string	可选值: `artifect_input_page` 默认: `"artifect_input_page"`
`inputKey`必填string
`ownerRevision`必填integer
`instructions`必填string
`items`可选StandoutItem[]	默认: `[]`
`coveredItemCount`必填integer
`itemCount`必填integer
`nextCursor`可选string \| null
`deadline`必填string
`decisionType`可选string	可选值: `STANDOUT_SELECTION` 默认: `"STANDOUT_SELECTION"`

ArtifectStatus14

Report the lifecycle projection of one Artifect instance.

`object`可选string	可选值: `artifect_status` 默认: `"artifect_status"`
`ref`必填ArtifectRef
`kind`必填ArtifectKind
`stage`必填TaskStage
`revision`必填integer
`pendingInput`必填ArtifectPendingInput \| null
`snapshotRef`必填string \| null
`updatedAt`必填string
`failureCode`可选string \| null	Stable failure refinement code while failed, when available.
`failureReason`可选string \| null	Host-authored failure sentence, set only while stage is FAILURE.
`failureType`可选TaskExceptionType \| null	keble-task failure class, set only while stage is FAILURE.
`latestAdjustment`可选ArtifectAdjustmentStatus \| null	Latest admitted adjustment's own execution state, or None when the Artifect has never been adjusted.
`standing`可选ArtifectStanding \| null	Standing state of a long-lived (STANDING) artifect: its state, who paused it and why, its next run, and its open and last occurrence. A STANDING artifect reads SUCCESS once set up; never wait for it to finish. Absent for every other kind.
`changeListStage`可选ChangeListStage \| null

Assess5

Ask the model to judge cells against assessments or criteria (today's criterion and retry).

`type`可选string	可选值: `ASSESS` 默认: `"ASSESS"`
`actionKey`必填string
`assessments`必填string[]
`cellKeys`可选string[] \| null
`missingOnly`可选boolean	默认: `false`

AssessmentDetailValue4

An ASSESSMENT detail row: one stored judgement for the cell.

`object`可选string	可选值: `assessment_detail_value` 默认: `"assessment_detail_value"`
`kind`可选string	可选值: `ASSESSMENT` 默认: `"ASSESSMENT"`
`key`必填string
`assessment`可选AssessmentResult \| null

AssessmentDisplay可选值 · 2

How an assessment row is drawn; the frontend owns the visuals.

可选值: TEXTINTERVAL

AssessmentKind可选值 · 2

What a model returns for one cell: numeric ranges, or yes/no with reasoning.

可选值: RANGEFLAG

AssessmentRange2

One numeric range an assessment returns.

`label`必填string
`unit`必填LocalizedText

AssessmentResult5

One judgement of one cell: ranges or a flag, with reasoning and references.

`status`必填ValueStatus
`ranges`可选RangeValue[]	默认: `[]`
`flag`可选boolean \| null
`reasoning`可选string	默认: `""`
`references`可选SourceReference[]	默认: `[]`

AssessmentRow3

A detail row showing one assessment: ranges or flag, its reasoning and references.

`kind`可选string	可选值: `ASSESSMENT` 默认: `"ASSESSMENT"`
`assessment`必填string
`display`可选AssessmentDisplay	默认: `"TEXT"`

AssetOrigin可选值 · 5

How an asset came to exist (provenance; the fidelity law and check read it).

可选值: UPLOADCUTOUT_MASKGENERATEDEXPORTREFERENCE

AssetRef6

An immutable, content-addressed image owned by one owner (bytes in object storage).

`assetId`必填string
`mediaType`必填ImageMediaType
`size`必填PixelSize
`byteCount`必填integer
`origin`必填AssetOrigin
`contentBox`可选Box \| null

Attribute2

One declared text column: an identity part, a dimension, or an account attribute.

`key`必填string	Text-column identifier; fact queries use its declared row path.
`title`必填StoreLocalizedText	Display name of the column, in both languages.

AttributeChange7

One identity-part or dim text value changed; an absent side is None, never empty text.

`entity`必填string	Stored entity key of the row that changed.
`observedAt`必填string	Instant the new value became readable.
`captureId`必填string	The capture that made the new value readable.
`kind`可选string	Discriminator marking this as an attribute change. 可选值: `attribute` 默认: `"attribute"`
`attributeKey`必填string	The declared attribute whose value changed.
`oldValue`可选string \| null	The value before the change; none when there was none.
`newValue`可选string \| null	The value after the change; none when it was removed.

AttributeMatch2

One declared attribute restricted to allowed values: a facts-request view selection.

`attributeKey`必填string	The declared family attribute this selection restricts.
`values`必填string[]	Values to match; at least one non-empty value.

Availability可选值 · 3

What is held for one account x family x day.

可选值: AVAILABLEINCOMPLETEUNAVAILABLE

BackgroundField2

Override value: the variant canvas background.

`field`可选string	可选值: `BACKGROUND` 默认: `"BACKGROUND"`
`background`必填Color \| BrandColorRef

BandedDimension2

A dimension core computes by cutting one numeric fact into bands.

`fact`必填string
`label`必填LocalizedText

BatchQuote4

What a batch would add and cost: a dry run of the same check and apply code, with no writes.

`newObjects`必填integer
`paid`可选OperationQuote[]	默认: `[]`
`estSeconds`必填integer
`refusal`可选EditRefusal \| null

BlendField2

Override value: a layer's blend mode (how its pixels mix with what is under it).

`field`可选string	可选值: `BLEND` 默认: `"BLEND"`
`blendMode`必填BlendMode

BlendMode可选值 · 6

How a layer mixes with pixels under it inside the same image.

可选值: NORMALMULTIPLYSCREENOVERLAYSOFT_LIGHTCOLOR

BlockedLane4

One blocked account x dataset lane as served: what is blocked, why, since when.

`account`必填AccountRef	The provider account whose lane is blocked.
`datasetKey`必填string	The dataset whose lane is blocked.
`issue`必填ProviderIssue	The typed reason the lane is blocked.
`since`必填string	When the lane became blocked.

BlogCreate3

Create one guided post set pinned to one ELTA store; the blog is chosen at DIRECTION.

`replayKey`必填string
`storeId`必填string
`brief`必填string

BlogDirection5

DIRECTION (1.1): what the posts are for and how the set is structured, agreed with the seller.

`step`可选string	可选值: `DIRECTION` 默认: `"DIRECTION"`
`blogId`必填string
`audience`必填string
`goal`必填string
`structure`必填string

BlogSnapshot9

The owner-visible post set at one revision, with its latest screen result and every filing.

`artifectRef`必填ArtifectRef
`storeId`必填string
`account`必填AccountRef
`revision`必填integer
`postSet`必填PostSet
`screening`可选ScreeningResult \| null
`proposals`可选ProposalFiling[]	默认: `[]`
`filingIntent`可选StagedProposal \| null
`approvals`可选ApprovalState[]	默认: `[]`

BlogStep可选值 · 6

The guided steps the agent is parked on, in order (owner 1.1-1.6).

可选值: DIRECTIONPOST_PLANSTYLE_EXAMPLESPOST_DRAFTSSELF_REVIEWSAMPLE_CONFIRMATION

BoardObjectKind可选值 · 3

The board object kinds (discriminator of BoardObject).

可选值: IMAGEPLANBRAND_KIT

BoardPoint2

Top-left of an object on the board, in board pixels (1 board px = 1 design px at zoom 1).

`x`必填number
`y`必填number

Box5

A layer's placement in canvas pixels; rotation in degrees around the box centre.

`x`必填number
`y`必填number
`width`必填number
`height`必填number
`rotation`可选number	默认: `0`

BoxField2

Override value: the layer's box.

`field`可选string	可选值: `BOX` 默认: `"BOX"`
`box`必填Box

Brand4

A DP-derived brand label and its existing product count.

`kind`可选string	Node discriminator; always BRAND. 可选值: `BRAND` 默认: `"BRAND"`
`key`必填string	The brand's own analyzed key, which is its identity.
`name`必填string	Brand display name.
`productCount`必填integer	Number of products carrying this brand; 0 for a brand known only from mentions.

BrandClause2

Filter a Product-like result by one or more explicit brand values.

`kind`可选string	可选值: `BRAND` 默认: `"BRAND"`
`values`必填string[]

BrandColorRef3

A colour that follows one kit entry. Swapping kits never re-points it (owner: any number of colours).

`ref`可选string	可选值: `BRAND` 默认: `"BRAND"`
`kitId`必填string
`entryId`必填string

BrandCorpusRef3

The frozen brand list one result was decided against, with its disclosed coverage.

`version`必填string
`sha256`必填string
`coverageDisclosure`必填string

BrandFontRef3

A font family that follows one kit font entry; the weight stays on the layer.

`ref`可选string	可选值: `BRAND` 默认: `"BRAND"`
`kitId`必填string
`entryId`必填string

BrandKit9

One owner-level kit as the backend serves it (read-only to product-images).

`kitId`必填string
`name`必填string
`tagline`可选string \| null
`handle`可选string \| null
`version`必填integer
`colors`可选KitColor[]	默认: `[]`
`fonts`可选KitFont[]	默认: `[]`
`archivedAt`可选string \| null
`updatedAt`必填string

Cancel2

Drop queued work; an unfinished run ends ABANDONED.

`type`可选string	可选值: `CANCEL` 默认: `"CANCEL"`
`actionKey`必填string

CapabilityRow7

One installed lookup, action or dataset, with what this store can do right now.

`key`必填string	Key of the lookup, action or dataset this row describes.
`sourceKey`必填string	Installed source that declares this item.
`accountId`必填string \| null	Stored account this row applies to; null exactly when state is NOT_CONNECTED.
`state`必填CapabilityState	What this item can do now.
`issue`可选ProviderIssue \| null	Known typed issue behind this state, if any.
`familyKey`可选string \| null	Write family of an action row; null for a lookup or dataset.
`blocked`可选BlockedLane[]	Blocked lanes of a dataset row; empty for a lookup or action. 默认: `[]`

CapabilityState可选值 · 8

Whether one lookup, action or dataset of a store can be used now, and what blocks it.

可选值: READYGRANT_UNKNOWNPERMISSION_MISSINGFAMILY_OFFSTORE_PAUSEDNOT_CONNECTEDRECONSENT_REQUIREDBLOCKED

CaptureStyle以下之一 · 3

以下之一: WindowCapture | ChangeCapture | ListingCapture · 区分字段 kind

CatalogAvailability可选值 · 3

Whether a source or published analyzed rows can answer a cell.

可选值: SUPPORTEDEXACT_ID_ONLYNONE

CatalogCellView11

One channel and kind's public capability cell.

`object`必填string	Public object discriminator. 可选值: `catalog_cell`
`channel`必填Channel	Channel represented by the cell.
`recordKind`必填AnalyzedRecordKind	Record family represented.
`nodeKind`必填NodeKind \| null	Node family, or null when the cell names no node kind.
`availability`必填CatalogAvailability	Whether an active source or published rows serve this cell.
`requiresMarket`可选boolean	Every active source for this channel and kind requires a market; false until a source declares it, never inferred from rows or markets. 默认: `false`
`acceptsWindow`可选boolean	Published rows of this kind have a windowed metric or feature binding. 默认: `false`
`markets`可选string[]	Markets declared by active sources for this channel and kind; empty means market-agnostic. 默认: `[]`
`fields`必填ColumnSpec[]	Authorized public columns.
`textFields`可选string[]	Searchable text fields a field-less text clause reads; empty when the kind serves none. 默认: `[]`
`seedCallBounds`可选SeedCallBound[]	Declared physical source calls per seed subject per page and page ceiling, per exact-seed selector; empty means unknown. 默认: `[]`

CatalogEdgeView7

One public catalog edge: an enabled topology hop a caller may use.

`object`必填string	Public object discriminator. 可选值: `catalog_edge`
`edgeId`必填string	Stable topology edge id.
`fromKind`必填NodeKind	Source node family of the hop.
`toKind`必填NodeKind	Target node family of the hop.
`analyzed`可选boolean \| null	Whether this edge has a stored leg; null means unknown.
`live`可选boolean \| null	Whether this edge has a live leg; null means unknown.
`relation`可选AnalyzedRelationKind \| null	Analyzed relationship followed by this edge; null for edges without a relation.

CatalogPairView8

One public catalog pair: a start-to-result walk this channel admits.

`object`必填string	Public object discriminator. 可选值: `catalog_pair`
`channel`必填Channel	Channel this pair walks on.
`fromKind`必填NodeKind	Start node family of the pair.
`toKind`必填NodeKind	Result node family of the pair.
`peers`可选PeerIntent \| null	Peer intent of a same-kind pair; null means identity or a plain conversion.
`analyzed`必填boolean	The planner admits this pair with an analyzed leg on every hop; not a stored-row guarantee.
`live`必填boolean	A live source read admits this pair in its mode.
`routes`必填string[][]	Ordered edge-id routes the planner admits, each hop an enabled edge id.

CategoryClause3

THE category carrier: filter by category values or provider category keys.

`kind`可选string	可选值: `CATEGORY` 默认: `"CATEGORY"`
`values`必填string[]
`op`可选string	可选值: `INNOT_IN` 默认: `"IN"`

Cell6

One cell of one dimension combination, computed when read.

`cellKey`必填string
`options`必填object
`groupKeys`必填string[]
`itemCount`必填integer
`measures`必填object
`results`必填object

CellDetail4

The dialog for one clicked cell: the view's criterion first (if any), then declared sections.

`cell`必填RoomCell
`criterion`可选AssessmentResult \| null
`sections`必填DetailSectionRead[]
`decisionPick`可选DecisionPick \| null

CellScore4

One scored cell: 0-100 score, tier 0-9, and each factor's percentile.

`cellKey`必填string
`score`必填integer
`tier`必填integer
`percentiles`必填object

ChangeCapture1

A dataset read as one continuous lane over the source's own update time.

kind可选string

Capture style: changes since the previous sync.

可选值: changes

默认: "changes"

ChangeFieldTitle2

Human title of one top-level field of an action's change, declared by the plugin.

`field`必填string	Top-level change field this title names.
`title`必填StoreLocalizedText	Bilingual display name of that change field.

ChangeList13

The persisted, revisioned list of one artifect with a frozen ELTA target.

`kind`必填ArtifectKind
`storeId`必填string	Keble identity that fences the owner and drives display.
`account`必填AccountRef	ELTA AccountRef resolved once at create; edits cannot retarget it.
`revision`必填integer
`revisedAt`必填string
`rows`必填ChangeRow[]
`privateValues`可选PrivateValue[]	默认: `[]`
`previewedAt`可选string \| null
`commandReceipts`可选CommandReceipt[]	默认: `[]`
`filed`可选FiledBatch[]	默认: `[]`
`reverts`可选FiledBatch[]	默认: `[]`
`filingIntent`可选FilingIntent \| null
`withdrawn`可选FiledBatch[]	默认: `[]`

ChangeListCreatePremise4

The replayable create body shared by change-list kinds, with an optional account selector.

`replayKey`必填string
`storeId`必填string	Keble identity that fences the owner and drives display.
`accountId`可选string \| null
`rows`必填NewChangeRow[]

ChangeListSnapshot10

What read returns: the public list, screening result, stage and guide.

`ref`必填ArtifectRef
`changeList`必填ChangeList
`screening`必填ScreeningResult \| null
`kindProblems`可选KindRuleProblem[]	默认: `[]`
`stage`必填ChangeListStage
`guide`必填StageGuide
`rowStages`必填ChangeRowStageView[]
`approvals`可选ApprovalState[]	默认: `[]`
`reverts`可选ApprovalState[]	默认: `[]`
`leafRules`可选LeafRule[]	默认: `[]`

ChangeListStage可选值 · 4

The derived stage of a row, and the aggregate used by the kind's guide.

可选值: DRAFTREADYPROPOSEDDECIDED

ChangeRow6

One proposed write: a bound ELTA action, its rationale and local inclusion state.

`rowKey`必填string
`action`必填ProviderAction
`rationale`必填string
`status`可选ChangeRowStatus	默认: `"KEPT"`
`origin`必填ChangeRowOrigin
`preview`可选RowPreview \| null

ChangeRowOrigin可选值 · 2

Who wrote a row first; set once by the engine and kept through every edit.

可选值: KIND_CREATEAGENT_ADD

ChangeRowStageView3

One row's stage and its live approval join, without duplicating approval state.

`rowKey`必填string
`stage`必填ChangeListStage
`inboxItemId`必填string \| null

ChangeRowStatus可选值 · 2

Whether the person keeps a row in the next proposal. Apply/revert state is ELTA's, never here.

可选值: KEPTDISCARDED

ChangesRequest9

A serving read of derived fact changes for one owner: the fact read's own selection.

`familyKey`必填string	The fact family to read.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`attributes`可选AttributeMatch[]	View selections that restrict which rows are returned. 默认: `[]`
`asOf`可选string \| null	Instant to read as of; set this or capture_id, never both.
`captureId`可选string \| null	Committed capture to read as of; set this or as_of, never both.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

Channel可选值 · 7

Identify a source channel without exposing its provider implementation.

可选值: AMAZONTIKTOKSHOPIFYALIBABA_1688YOUTUBEINSTAGRAMREDDIT

ChargeRefusalCode可选值 · 1

Why the money owner refused one paid step, when the payer can act on it (0.6.0).

可选值: INSUFFICIENT_BALANCE

ClaimEmotion可选值 · 5

How the item feels about the claimed entity, on a 5-level scale.

可选值: STRONGLY_NEGATIVENEGATIVENEUTRALPOSITIVESTRONGLY_POSITIVE

ClaimStance可选值 · 4

The stance one claim's supporting text shows toward the entity.

可选值: RECOMMENDSNEUTRALCRITICIZESCOMPARES_AGAINST

ClarificationAnswer2

The console's reply to one CLARIFY: the stored partial query the choice binds into, and the choice itself.

`queryKey`必填string	Key of the stored partial query this choice binds into.
`choice`必填string	The caller's chosen answer among the offered choices.

Classify4

Ask the model to place groups into the named dimensions (all relevant groups when None).

`type`可选string	可选值: `CLASSIFY` 默认: `"CLASSIFY"`
`actionKey`必填string
`dimensionKeys`必填string[]
`itemKeys`可选string[] \| null

Color1

An sRGB colour with alpha, stored as #rrggbbaa.

hex必填string

ColorField2

Override value: a text layer's colour.

`field`可选string	可选值: `COLOR` 默认: `"COLOR"`
`color`必填Color \| BrandColorRef

ColorRemap2

Replace one authored colour value (hex or kit ref) with another, by exact match, before kit lookup.

`source`必填Color \| BrandColorRef
`target`必填Color \| BrandColorRef

ColumnSpec4

One public result column: its field code, scalar type and, for a money cell, its unit and the column carrying the paired currency.

`name`必填string	Field code of this result column.
`valueType`必填string	Scalar type the column's values carry; DECIMAL is a major-unit number carried as a JSON string. 可选值: `STRINTFLOATBOOLTIMESTAMPDECIMALNULL`
`unit`可选MetricUnit \| null	Metric unit of the cell's values; null when the column declares none.
`currencyColumn`可选string \| null	Sibling column carrying the currency; set iff unit is MONEY.

Combine以下之一 · 3

以下之一: SumCombine | LastCombine | RatioCombine · 区分字段 kind

CommandReceipt3

Record one successful caller command for bounded replay and conflict detection.

`replayKey`必填string
`bodySha256`必填string
`revision`必填integer

Comment9

Represent one comment nested beneath its Content item.

`externalId`必填string
`parentExternalId`可选string \| null
`authorName`可选string \| null
`authorHandle`可选string \| null
`authorRef`可选SourceSubject \| null
`body`可选string \| null
`publishedAt`可选string \| null
`depth`可选integer	默认: `0`
`metrics`可选MetricObservation[]	默认: `[]`

ComposedPost7

One post as the composer edits and renders it: title, featured image, ordered blocks, metadata.

`title`必填string
`handleStem`必填string
`featuredImage`可选ExistingShopifyFile \| ShopifyRemoteImage \| PostExportedImage \| null
`blocks`必填HeadingBlock[] \| ParagraphBlock[] \| ListBlock[] \| ImageBlock[] \| QuoteBlock[]
`summary`可选string \| null
`tags`可选string[]	默认: `[]`
`author`必填string

Concept6

An extracted concept attached to one scoped source record.

`kind`可选string	Node discriminator; always CONCEPT. 可选值: `CONCEPT` 默认: `"CONCEPT"`
`conceptKind`必填ConceptKind	Which kind of concept this is.
`key`必填string	Per-item concept identity, 'revision:label'.
`label`必填string	Normalized label text of the concept.
`subjectRefs`必填NodeRef[]	Scoped references to the source records this concept was extracted from.
`itemCount`必填integer	Number of source items carrying this concept.

ConceptKind可选值 · 14

Concept records the extract capability yields, in two families.

可选值: CATEGORYATTRIBUTEPROBLEMUSER_NEEDMECHANISMINDUSTRYHOOKFORMATSELLING_POINTSCENEVISUALLOGOICONPATTERN

ConceptRef2

ONE CONCEPT A RECORD WAS FOUND TO BE ABOUT: the label the extract capability normalized, TOGETHER WITH which kind of concept it is.

`label`必填string	Normalized label of the concept.
`kind`必填ConceptKind	Which kind of concept the label names.

ConclusionDetailValue5

A CONCLUSION detail row: the cell's status and, when a signal is raised, its prose.

`object`可选string	可选值: `conclusion_detail_value` 默认: `"conclusion_detail_value"`
`kind`可选string	可选值: `CONCLUSION` 默认: `"CONCLUSION"`
`key`必填string
`conclusion`必填ConclusionStatus
`assessment`可选AssessmentResult \| null

ConclusionRow2

The cell's tinted conclusion: the first raised signal wins, else NEUTRAL.

`kind`可选string	可选值: `CONCLUSION` 默认: `"CONCLUSION"`
`signals`必填ConclusionSignal[]

ConclusionSignal2

One FLAG assessment that, when raised, sets the conclusion's tone.

`assessment`必填string
`tone`必填Tone

ConclusionStatus可选值 · 4

A cell's conclusion (today's detail status values).

可选值: OPPORTUNITYCAUTIONNEUTRALUNAVAILABLE

ConnectStyle可选值 · 2

How an owner binds a source: a consent redirect, or credentials they enter.

可选值: CONSENTCREDENTIALS

ConnectionRecord15

One owner's grant for one plugin source, and the accounts it reaches.

`object`可选string	Document type: connector record. 可选值: `connection_record` 默认: `"connection_record"`
`connectionId`必填string	Connector identifier within the asserted owner scope.
`storeId`必填string	Store this connector belongs to.
`sourceKey`必填string	Catalog source authorized by this connector.
`status`必填ConnectionStatus	Current authorization state.
`accounts`可选DiscoveredAccount[]	Accounts reached by this connector. 默认: `[]`
`regions`可选ProviderRegion[]	Sales regions reached by the discovered accounts. 默认: `[]`
`boundAt`必填string	When the connector was first bound.
`consentedAt`可选string \| null	Latest successful consent instant; null when no consent was recorded.
`lastSyncedAt`可选string \| null	When this connection last synced successfully.
`syncedThrough`可选string \| null	Provider data instant this connection synced through.
`boundWith`必填ConnectStyle	The way the current grant was bound.
`reconsentDueAt`可选string \| null	When the owner must renew this connection's grant (rotate an expiring credential, or consent again), if a declared lifetime makes it known; null when nothing expires.
`issue`可选ProviderIssue \| null	Invalid-access reason requiring renewed consent, if present.
`removing`可选boolean	A removal started and has not finished. The record is kept only so the same DELETE can finish it: capture, binding and lifecycle commands refuse it. False for every normal record. 默认: `false`

ConnectionStatus可选值 · 3

Where one bound connection stands.

可选值: PENDINGACTIVERECONSENT_REQUIRED

Contact9

Represent one creator-linked contact record with optional contact facts.

`kind`可选string	可选值: `CONTACT` 默认: `"CONTACT"`
`channel`必填Channel
`externalId`必填string
`creatorRef`必填SourceSubject
`email`可选string \| null
`whatsapp`可选string \| null
`instagram`可选string \| null
`observedAt`必填string
`provenance`必填Provenance

ContactClause2

The CREATOR result has a stored CONTACT carrying every named contact fact.

`kind`必填string	可选值: `CONTACT`
`present`必填string[]	CONTACT field codes that must all be present and non-empty on one stored contact of the creator.

Content24

Represent one published item with typed creator/product references.

`kind`可选string	可选值: `CONTENT` 默认: `"CONTENT"`
`channel`必填Channel
`externalId`必填string
`contentType`必填ContentType
`title`可选string \| null
`body`可选string \| null
`hashtags`可选string[]	默认: `[]`
`creatorRef`可选SourceSubject \| null
`creatorName`可选string \| null
`creatorHandle`可选string \| null
`community`可选string \| null
`publishedAt`可选string \| null
`metrics`可选MetricObservation[]	默认: `[]`
`media`可选MediaRef[]	默认: `[]`
`productRefs`可选SourceSubject[]	默认: `[]`
`language`可选string \| null
`mentionedRefs`可选SourceSubject[]	默认: `[]`
`sponsorship`可选ContentSponsorship	默认: `"UNKNOWN"`
`market`可选string \| null
`textTracks`可选SocialTextTrack[]	默认: `[]`
`comments`可选Comment[]	默认: `[]`
`status`可选ContentStatus	默认: `"AVAILABLE"`
`observedAt`必填string
`provenance`必填Provenance

ContentRef5

THE single content-addressed reference. Object key ends in the sha256 — content-addressing holds by construction. Bytes are read only through the owner's bytes protocol, never a storage credential.

`store`必填StoreOwner
`objectKey`必填string
`sha256`必填string
`byteCount`必填integer
`mediaType`必填string

ContentSource可选值 · 2

Whether an image owns its canvas or resolves from an OWN parent (discriminator of ImageContent).

可选值: OWNVARIANT

ContentSponsorship可选值 · 4

What the platform itself declares about payment for one Content item.

可选值: ORGANICPAID_ADPAID_PARTNERSHIPUNKNOWN

ContentStatus可选值 · 4

Describe whether one Content item remains available.

可选值: AVAILABLEDELETED_BY_AUTHORREMOVED_BY_MODERATORUNKNOWN

ContentType可选值 · 4

Describe the provider-neutral presentation form of one Content item.

可选值: VIDEOIMAGETEXTTHREAD

Continue3

Accept the reviewed step's current result (as edited) and let the run go on.

`type`可选string	可选值: `CONTINUE` 默认: `"CONTINUE"`
`actionKey`必填string
`after`必填RunStep

ContinueRequest2

A signed continuation request with an optional per-call row ceiling.

`cursor`必填string	Opaque signed continuation token.
`maxRows`可选integer \| null	Optional row ceiling for this call; the next cursor follows the last returned row. Omission preserves the normal page size.

CostProfile18

Canonical calculator input with currency-aware Money observations.

`len1`必填number
`len2`必填number
`len3`必填number
`lenUnit`必填string	可选值: `cmminch`
`marketplace`必填AmazonMarketplace
`weight`必填number
`weightUnit`必填string	可选值: `poundouncekgg`
`expectedAdsCostRatio`必填number
`expectedCustomerReturnedRatio`可选number	默认: `0.025`
`expectedPurchasingCost`必填MinorUnitMoney
`expectedAverageDailyInventoryVolume`必填integer
`expectedAverageDailyShippedVolume`必填integer
`isApparel`必填boolean
`isDangerousGoods`必填boolean
`isBattery`必填boolean
`feeCategoryString`必填string
`exchangeRates`必填ExchangeRateInUsd[]
`price`必填MinorUnitMoney

CoverageNote4

ONE disclosed gap in the world the page was computed over . UNLINKED_CLAIMS: claims touching a relation the query used with no accepted edge. UNHYDRATED_ENDPOINTS: linked endpoint records with no stored profile (including key-only stores/categories), not a short page. MISSING_OBSERVATIONS: rows whose metric series has no observation in the resolved window.

`kind`必填GapKind	Non-empty-cause gap this note discloses.
`count`必填integer	Distinct records the gap covers: for MISSING_OBSERVATIONS the searched result-kind records whose series has no observation in the resolved window, in the freshness unit (records, not versions); for UNLINKED_CLAIMS the distinct claims, not result records; for UNHYDRATED_ENDPOINTS the distinct linked endpoint records with no stored profile.
`detail`必填string	Plain description of the gap.
`total`可选integer \| null	Distinct records of the searched kind in scope; absent when the gap has no record population.

CreateImageSet5

Create an image set from already-uploaded product photos.

`replayKey`必填string
`title`必填string
`brief`必填ProductBrief
`presets`可选string[]	默认: `[]`
`actions`可选AddDesign[] \| RemoveDesign[] \| OrderDesigns[] \| ResizeDesign[] \| SetBackground[] \| ApplyTemplate[] \| AddLayer[] \| RemoveLayers[] \| OrderLayer[] \| SetBox[] \| SetLayerFlags[] \| SetText[] \| SetTextStyle[] \| SetShapeStyle[] \| SetShadow[] \| GroupLayers[] \| UngroupLayer[] \| CutOutProduct[] \| GenerateScene[] \| RestoreRevision[] \| SetObjectFrame[] \| SetObjectLock[] \| CreateVariants[] \| SetVariantRecipe[] \| DetachVariant[] \| AddPlan[] \| SetPlan[] \| GenerateFromPlan[] \| PlaceBrandKit[] \| SetImageTransform[] \| GenerateDecor[] \| SetBoardTitle[]	默认: `[]`

CreateResult3

Stored item and whether the call admitted a new row.

`object`可选string	可选值: `create_result` 默认: `"create_result"`
`item`必填TodoItem \| AlertItem \| ApprovalItem \| NotificationItem
`created`必填boolean

CreateVariants3

Create variants of one OWN image; free unless a spec carries a scene prompt (each its own paid step).

`action`可选string	可选值: `CREATE_VARIANTS` 默认: `"CREATE_VARIANTS"`
`sourceId`必填string
`variants`必填VariantSpec[]

Creator13

Represent one publishing account without inferring a real-world person.

`kind`可选string	可选值: `CREATOR` 默认: `"CREATOR"`
`channel`必填Channel
`externalId`必填string
`name`必填string
`handle`可选string \| null
`biography`可选string \| null
`market`可选string \| null
`links`可选string[]	默认: `[]`
`verified`可选boolean \| null
`metrics`可选MetricObservation[]	默认: `[]`
`media`可选MediaRef[]	默认: `[]`
`observedAt`必填string
`provenance`必填Provenance

CreatorHandleSuggestion2

Prefill a creator handle input; this suggestion never runs a search.

`kind`可选string	Handle-prefill suggestion discriminator. 可选值: `CREATOR_HANDLE` 默认: `"CREATOR_HANDLE"`
`channel`必填Channel	Channel of the creator handle to enter.

Credential8

One piece of grant material the source declares, entered by the owner or returned.

`key`必填string	Credential field identifier.
`label`可选string \| null	Label for an owner-entered credential field.
`entered`可选boolean	Whether the owner enters this value when connecting. 默认: `false`
`secret`可选boolean	Whether this value must be hidden when displayed. 默认: `true`
`updatable`可选boolean	Whether the owner may replace this entered value alone on the held connection. 默认: `false`
`required`可选boolean	Whether the binding form requires this entered value. 默认: `true`
`lifetimeDays`可选integer \| null	Days after entry the value stops working, when the provider forces a renewal.
`renewHint`可选StoreLocalizedText \| null	Where the owner gets a new value once this one expires, in both languages.

CriterionRecord3

A FLAG assessment a person or agent made after create (today's custom mask).

`key`必填string
`label`必填LocalizedText
`prompt`必填string

CropField2

Override value: an image layer's crop (None = uncropped).

`field`可选string	可选值: `CROP` 默认: `"CROP"`
`crop`必填Box \| null

Currency可选值 · 159

Currencies full list: https://en.wikipedia.org/wiki/ISO_4217#Active_codes

可选值: AEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBYRBZDCADCDFCHFCLPCNYCOPCRCCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPGBPGELGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSINRIQDIRRISKJEPJMDJODJPYKESKGSKHRKIDKMFKRWKWDKYDKZTLAKLBPLKRLRDLSLLTLLVLLYDMADMDLMGAMKDMMKMNTMOPMRUMURMVRMWKMXNMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLLSOSSRDSSPSTDSYPSZLTHBTJSTMTTNDTOPTRYTTDTWDTZSUAHUGXUSDUYUUZSVEFVESVNDVUVWSTXAFXCDXOFXPFXXXYERZARZMW

CurrencyBasis可选值 · 2

State how a MONEY value's currency is known.

可选值: STATEDASSUMED

CustomerArtifectCreateResponse以下之一 · 3

Expose an Artifect reference or sanitized Artifect failure.

以下之一: ArtifectRef | ArtifectAccountRequired | ArtifectFailure · 区分字段 object

CustomerArtifectDecisionResponse以下之一 · 4

Expose an Artifect decision status, rejection or sanitized failure.

以下之一: ArtifectStatus | ArtifectDecisionRejection | ArtifectFailure | ArtifectProductImagesQuote · 区分字段 object

CustomerArtifectDetailResponse以下之一 · 2

Expose one kind-typed Artifect detail answer or sanitized failure.

以下之一: ArtifectDetail | ArtifectFailure · 区分字段 object

CustomerArtifectInputPage以下之一 · 10

CustomerArtifectInputResponse以下之一 · 3

Expose an Artifect input page, a terminal-run rejection or a sanitized failure.

以下之一: CustomerArtifectInputPage | ArtifectDecisionRejection | ArtifectFailure · 区分字段 object

CustomerArtifectPluginListResponse2

Expose the installed positioning plugins in a JSON-object envelope.

`object`可选string	可选值: `artifect_plugin_list` 默认: `"artifect_plugin_list"`
`plugins`必填RoomPublicDeclaration[]

CustomerArtifectSnapshotResponse以下之一 · 2

Expose an Artifect snapshot or sanitized failure.

以下之一: ArtifectSnapshot | ArtifectFailure · 区分字段 object

CustomerArtifectStatusResponse以下之一 · 2

Expose an Artifect lifecycle status or sanitized failure.

以下之一: ArtifectStatus | ArtifectFailure · 区分字段 object

CustomerDpCatalogResponse以下之一 · 2

Expose the DP catalog or its typed refusal as one customer root schema.

以下之一: CapabilityCatalog | SearchRefused · 区分字段 object

CustomerDpContinueResponse以下之一 · 4

Expose one discriminated DP continuation answer.

以下之一: SearchPage | EntityPage | SearchPending | SearchRefused · 区分字段 object

CustomerDpFreshnessResponse以下之一 · 2

Expose the DP freshness projection or its typed refusal.

以下之一: Freshness | SearchRefused · 区分字段 object

CustomerDpMotifsResponse以下之一 · 3

Expose one DP motif page, its pending variant or a typed refusal.

以下之一: EntityPage | SearchPending | SearchRefused · 区分字段 object

CustomerDpRecordResponse以下之一 · 2

Expose one DP record detail or its typed refusal.

以下之一: RecordDetail | SearchRefused · 区分字段 object

CustomerDpSearchResponse以下之一 · 6

Expose the full discriminated DP search answer without copying DP fields.

CustomerInboxItemResponse以下之一 · 4

Expose the inbox owner's todo/approval union without copying either item model.

以下之一: TodoItem | AlertItem | ApprovalItem | NotificationItem · 区分字段 kind

CutOutProduct3

Paid: cut the product out of a PRODUCT layer's photo.

`action`可选string	可选值: `CUT_OUT_PRODUCT` 默认: `"CUT_OUT_PRODUCT"`
`designId`必填string
`layerId`必填string

Dataset6

One captured dataset, including the visible provider-number parity label.

`key`必填string	Captured dataset identifier.
`families`必填Family[]	Fact families produced by this dataset.
`capture`必填CaptureStyle	How this dataset is captured and scheduled.
`backfillDays`必填integer	Historical days initially captured within source retention.
`requires`可选Permission[]	Permissions needed to capture this dataset. 默认: `[]`
`unverified`可选boolean	Whether equality with source-reported totals remains unverified. 默认: `false`

DateClause4

Bound one launch instant from below or above.

`kind`可选string	可选值: `DATE` 默认: `"DATE"`
`field`必填string	可选值: `released_atpublished_atfirst_tracked_at`
`op`必填string	可选值: `GTELTE`
`value`必填string

DateWindow2

Bound one explicit inclusive calendar window for keyword trend reads.

`start`必填string
`end`必填string

DayCoverage6

What is held for one account x family x day, and whether it is settled.

`account`必填AccountRef	The provider account this coverage is for.
`familyKey`必填string	The fact family this coverage is for.
`day`必填string	The reporting day this coverage is for.
`availability`必填Availability	What is held for this account, family and day.
`maturity`必填Maturity	Whether the value may still be restated by the source.
`capturedAt`可选string \| null	Newest capture that confirmed this day; none when unconfirmed.

DayRange2

Inclusive reporting days in one account's timezone.

`startsOn`必填string	First reporting day, inclusive.
`endsOn`必填string	Last reporting day, inclusive.

Decide2

Start one decision over the current scorecard (explicit intent; part of the run, never a separate run). The host owns settlement.

`type`可选string	可选值: `DECIDE` 默认: `"DECIDE"`
`actionKey`必填string

Decider可选值 · 2

Who decides a step's result before the run moves on.

可选值: MODELCALLER

DecisionPick4

One recommended cell with its score, headline and the model's explanation (when written).

`cellKey`必填string
`score`必填integer
`title`可选string \| null
`prose`可选string \| null

DecisionRecord3

The latest decision over the scorecard; headline and prose may be unavailable while picks stand.

`decisionId`必填string
`status`必填DecisionStatus
`picks`可选DecisionPick[]	默认: `[]`

DecisionRefusal可选值 · 3

Why core cannot offer a decision run now (existing wire tokens; the frontend maps copy).

可选值: NO_EVIDENCERUN_IN_FLIGHTTABLE_NOT_READY

DecisionStatus可选值 · 3

A decision run is one explicit intent; only one runs at a time (existing ruling).

可选值: RUNNINGSUCCEEDEDFAILED

DeleteCriterion3

Delete one criterion and its results; views naming it show no criterion.

`type`可选string	可选值: `DELETE_CRITERION` 默认: `"DELETE_CRITERION"`
`actionKey`必填string
`key`必填string

DeleteDimension3

Delete one dimension and its placements; views naming it fall back to their other axes.

`type`可选string	可选值: `DELETE_DIMENSION` 默认: `"DELETE_DIMENSION"`
`actionKey`必填string
`dimensionKey`必填string

DeleteView5

Delete one saved view from the viewer's viewport (the first definition cannot be deleted).

`type`可选string	可选值: `DELETE_VIEW` 默认: `"DELETE_VIEW"`
`actionKey`必填string
`viewer`必填ViewerRef
`expectedRevision`必填integer
`viewId`必填string

DetachVariant2

Freeze a variant's resolved design into OWN content (kit refs stay refs); it stops following its parent.

`action`可选string	可选值: `DETACH_VARIANT` 默认: `"DETACH_VARIANT"`
`objectId`必填string

DetailSection3

One section of the dialog a person opens by clicking a cell.

`key`必填string
`title`必填LocalizedText
`rows`必填MeasureRow[] \| AssessmentRow[] \| ConclusionRow[] \| ItemsRow[] \| ReferencesRow[]

DetailSectionRead2

One declared section with its rows filled for one cell.

`section`必填DetailSection
`values`必填MeasureDetailValue[] \| AssessmentDetailValue[] \| ConclusionDetailValue[] \| ItemsDetailValue[] \| ReferencesDetailValue[]

DiffLine6

One mutation or estimate line, optionally private or a raw text hunk.

`kind`必填DiffLineKind	Diff-line operation and display color.
`field`必填string	Changed field name or quote JSON pointer.
`before`可选JsonValue \| null	Previous field value, when present.
`after`可选JsonValue \| null	Requested value or estimate, when present.
`private`可选boolean	Whether this line contains owner-only data. 默认: `false`
`textHunks`可选TextHunk[]	Raw line operations for a text-file diff. 默认: `[]`

DiffLineKind可选值 · 4

Meaning and display treatment of one requested change or provider estimate.

可选值: ADDEDCHANGEDREMOVEDESTIMATE

DimensionOrigin可选值 · 2

Where a dimension's placements come from: cut from a fact, or judged (model or caller).

可选值: COMPUTEDCLASSIFIED

DimensionRecord5

One dimension of a positioning and its ordered options.

`key`必填string
`label`必填LocalizedText
`origin`必填DimensionOrigin
`fact`可选string \| null
`options`必填OptionRecord[]

DiscardRow2

Leave one row out of the next proposal; it stays visible and restorable.

`op`可选string	可选值: `DISCARD_ROW` 默认: `"DISCARD_ROW"`
`rowKey`必填string

DiscoveredAccount7

An account a binding reaches, as the plugin reports it at discovery.

`accountId`必填string	Account identifier within the source.
`title`必填string	Account display name.
`timezone`必填string	Account's reporting timezone.
`currency`可选string \| null	Account currency; null when no money is reported.
`region`可选ProviderRegion \| null	Sales region reached by this account; null for sources without regional accounts.
`attributes`可选object	Account metadata keyed by the source's declared attributes. 默认: `{}`
`granted`可选Permission[] \| null	Permissions reported for this account; null when they cannot be listed.

DocumentOutline8

The artifect snapshot the chat agent reads before each turn; pixels travel separately (previews).

`status`必填SetStatus
`revision`必填integer
`title`必填string
`kits`必填BrandKit[]
`photos`必填OwnedPhotoRef[]
`objects`必填ObjectOutline[]
`focus`可选string[]	默认: `[]`
`latestEdit`可选EditSummary \| null

DpCatalogRequest1

The dp_catalog request: the caller only chooses whether DP's per-channel pairs are included.

includePairs可选boolean

Also list each channel's start-to-result pairs (planner-admitted walks, with analyzed and live modes); off by default because the list is large.

默认: false

DriftPolicy可选值 · 2

Whether a write may proceed after its target changed since preview.

可选值: APPLY_ANYWAYREFUSE

DropPost2

Leave one post out of create-all.

`edit`可选string	可选值: `DROP_POST` 默认: `"DROP_POST"`
`postKey`必填string

DropShadow4

A rendered shadow under any leaf layer (procedural, deterministic, free).

`color`必填Color \| BrandColorRef
`blur`必填number
`offsetX`可选number	默认: `0`
`offsetY`可选number	默认: `0`

EditActionKind可选值 · 32

Every edit the agent or the editor can make (discriminator of EditAction).

可选值: ADD_DESIGNREMOVE_DESIGNORDER_DESIGNSRESIZE_DESIGNSET_BACKGROUNDAPPLY_TEMPLATEADD_LAYERREMOVE_LAYERSORDER_LAYERSET_BOXSET_LAYER_FLAGSSET_TEXTSET_TEXT_STYLESET_SHAPE_STYLESET_SHADOWGROUP_LAYERSUNGROUP_LAYERCUT_OUT_PRODUCTGENERATE_SCENERESTORE_REVISIONSET_OBJECT_FRAMESET_OBJECT_LOCKCREATE_VARIANTSSET_VARIANT_RECIPEDETACH_VARIANTADD_PLANSET_PLANGENERATE_FROM_PLANPLACE_BRAND_KITSET_IMAGE_TRANSFORMGENERATE_DECORSET_BOARD_TITLE

EditRefusal8

A refused batch or step, pointing at the first offending action so the agent can fix and resubmit.

`outcome`可选string	可选值: `REFUSED` 默认: `"REFUSED"`
`code`必填EditRefusalCode
`actionIndex`可选integer \| null
`layerId`可选string \| null
`objectId`可选string \| null
`changedObjects`可选string[]	默认: `[]`
`limit`可选integer \| null
`chargeRefusal`可选ChargeRefusalCode \| null

EditRefusalCode可选值 · 25

Why a batch (or a paid step on re-check) was not applied; the head is unchanged in every case.

可选值: STALE_REVISIONUNKNOWN_DESIGNUNKNOWN_LAYERUNKNOWN_REVISIONUNKNOWN_ASSETDUPLICATE_IDWRONG_LAYER_KINDWRONG_ROLELAYER_LOCKEDTEMPLATE_PRESET_MISMATCHMISSING_FILLMISSING_MASKAI_PAUSEDPAYMENT_REFUSEDINVALID_ACTION_BATCHOBJECT_LOCKEDOBJECT_BUSYPARENT_IS_VARIANTDETACH_REQUIREDHAS_VARIANTSUNKNOWN_PLAN_ROWUNKNOWN_BRAND_KITBOARD_FULLBATCH_TOO_LARGEINVALID_SIZE

EditRow4

Replace one row's account-free action without changing key, type or target.

`op`可选string	可选值: `EDIT_ROW` 默认: `"EDIT_ROW"`
`rowKey`必填string
`action`必填UnboundAction
`rationale`可选string \| null

EditSummary6

One recorded edit summary for the agent's last-change card and the editor's version history.

`revision`必填integer
`actor`必填ProductImagesActorKind
`actionTypes`必填EditActionKind[]
`changedObjects`必填string[]
`committedAt`必填string
`batchKey`可选string \| null

EllipseGeometry1

An ellipse inscribed in the box (callout dots, circular badges).

kind可选string

可选值: ELLIPSE

默认: "ELLIPSE"

EntityLevel3

One catalog-declared entity level: its key, bilingual title and one-hop parent.

`key`必填string	Level key carried by every value.
`title`必填StoreLocalizedText	Display name of the level, in both languages.
`parent`可选string \| null	Level whose entity scopes this one; never itself parented.

EntityPage10

One customer page with honest progress and an opaque continuation.

`coveragePartial`可选boolean	Coverage notes were counted over a candidate batch or suppressed, so whole-cell counts are unknown; also set when the page's rows, including a successful empty page, cover only a frozen lexical candidate set, leaving records with no PHRASE hit or ranked beyond the retained window unreachable. 默认: `false`
`object`必填string	Public object discriminator. 可选值: `entity_page`
`items`必填NodeHit[]	Final typed node hits in page order.
`cursor`必填string \| null	Opaque signed short token for continuation; null when complete.
`progress`必填PageProgress	Requested count and progress per step.
`coverage`可选CoverageNote[]	Disclosed gaps in the world this page searched. 默认: `[]`
`unapplied`可选string[]	At most eight request parts that this page did not apply. 默认: `[]`
`families`可选FamilySummary[]	Product families represented by this page's listings. 默认: `[]`
`window`可选ResolvedWindow \| null	Time axis and inclusive span read; null when none.
`market`可选string \| null	Resolved market this page read; null when unknown or unset.

EntityRef4

One provider entity at a declared level, optionally scoped by its typed parent.

`level`必填string	Granularity of the entity: a catalog level key.
`entity`必填string	Identifier at the declared granularity.
`parent`可选EntityRef \| null
`label`可选string \| null	Display title only, never identity; excluded from proposal hashes and target keys.

EstimateSource可选值 · 5

Provenance of one economic input used by a profit breakdown line.

可选值: AMAZON_OBSERVEDUSER_SUPPLIEDCOHORT_INFERREDPUBLIC_WEB_RESEARCHUNRESOLVED

EstimationStatus可选值 · 3

State whether a reported metric is actual, estimated, or unknown.

可选值: UNKNOWNACTUALESTIMATED

EvidenceBasis可选值 · 3

HOW STRONGLY a fact supports a hit.

可选值: RECORDEDMENTIONEDSIMILAR

ExchangeRateInUsd2

Legacy fixed-two quote expressing currency major units per one USD.

`currency`必填Currency
`exchangeRate`必填StdMoneyAmount

ExcludeAsinsAdjustment2

Remove ASINs from the analysis and recompute dependent sections.

`adjustmentType`可选string	可选值: `EXCLUDE_ASINS` 默认: `"EXCLUDE_ASINS"`
`asins`必填string[]	ASINs removed from the analysis.

ExistingShopifyFile2

An image body segment that refers to a file already in this Shopify store.

`file_id`必填string
`alt_text`可选string	默认: `""`

ExportOptions4

How an export renders: format, scale, which images, or one layer alone (stated once per export).

`format`可选RenderFormat \| null
`scale`可选number	默认: `1`
`objectIds`可选string[] \| null
`layerId`可选string \| null

ExportSet6

An immutable, ordered group of rendered images pinned to one revision: what the listing artifect consumes.

`exportId`必填string
`setId`必填string
`revision`必填integer
`options`可选ExportOptions
`images`必填ExportedImage[]
`createdAt`必填string

ExternalIdentity3

Retain a universal product alias without provider attribution.

`kind`必填ExternalIdentityKind
`value`必填string
`market`可选string \| null

ExternalIdentityKind可选值 · 5

Name provider-neutral product aliases that are safe for consumer data.

可选值: GTINEANUPCSKUMODEL_NUMBER

FactChange以下之一 · 2

以下之一: AttributeChange | MeasureChange · 区分字段 kind

FactChangePage4

One bounded page of derived fact changes; total_rows counts every change matched.

`rows`必填FactChange[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.

FactHistoryResponse5

One bounded page of every stored version, superseded ones included.

`rows`必填FactVersion[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Fixed tag marking this object as a fact history page. 可选值: `fact_history_response` 默认: `"fact_history_response"`

FactPage8

One bounded page of fact rows plus the coverage of every requested day.

`rows`必填FactRow[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Fixed tag marking this object as a fact page. 可选值: `fact_page` 默认: `"fact_page"`
`coverage`必填DayCoverage[]	Coverage of every requested account, family and day.
`readAsOf`必填string	The single instant all rows were read at.
`blocked`可选BlockedLane[]	Blocked lanes with their reason and fix. 默认: `[]`

FactRow8

One stored fact value: identity values, day, typed cells.

`account`必填AccountRef	The provider account this row belongs to.
`familyKey`必填string	The fact family this row belongs to.
`identity`必填string[]	One value per family identity attribute, in declared order.
`parents`可选EntityRef[]	默认: `[]`
`day`必填string	The reporting day this value is for.
`occurredAt`可选string \| null	When the event happened; only for event-style families.
`measures`可选object	Measure values keyed by declared measure key; absent is unknown. 默认: `{}`
`dims`可选object	Attribute values keyed by declared attribute key. 默认: `{}`

FactSpec3

One fact every item of this plugin may carry.

`key`必填string
`label`必填LocalizedText
`kind`必填FactValueKind

FactVersion5

One stored version of one fact row (change-only history).

`row`必填FactRow	The stored fact row this version belongs to.
`captureId`必填string	The capture whose processing made this version readable.
`contentHash`必填string	Hash of the row content used to detect a new version.
`observedAt`必填string	Instant this version became readable.
`supersededAt`可选string \| null	Instant a newer version replaced this one; none while current.

FactsRequest9

A serving read of stored facts for one owner: family, days, selection and pin.

`familyKey`必填string	The fact family to read.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`attributes`可选AttributeMatch[]	View selections that restrict which rows are returned. 默认: `[]`
`asOf`可选string \| null	Instant to read as of; set this or capture_id, never both.
`captureId`可选string \| null	Committed capture to read as of; set this or as_of, never both.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

FailureRef2

A typed, self-describing reference to one durable failure record.

`kind`必填FailureRefKind	Store the referenced durable record lives in.
`id`必填string	Durable record id in that store.

FailureRefKind可选值 · 1

What kind of durable record a public failure reference names.

可选值: PUBLIC_REQUEST

Family8

One family of facts: identity, time placement, columns and settle window.

`key`必填string	Fact-family identifier.
`kind`必填TemporalFactKind	How these facts are placed in time.
`level`必填string	Granularity of each fact row: a catalog level key.
`identity`必填Attribute[]	Ordered text columns identifying a fact.
`dims`可选Attribute[]	Additional descriptive text columns. 默认: `[]`
`measures`必填Measure[]	Numeric columns reported by this family.
`settlesAfterDays`必填integer	Days after reporting before a value is final; zero means final on capture.
`absence`必填AbsencePolicy	Meaning of an entity missing from a confirmed day.

FamilySummary6

One product family on a page: its label, size and price range.

`familyKey`必填string	Stable family key, matching NodeHit.family_key.
`label`必填string	Readable family label.
`memberCount`必填integer	Listings in this family.
`priceCurrency`可选Currency \| null	Currency of min_price and max_price.
`minPrice`可选number \| string \| null	Lowest member price in major units.
`maxPrice`可选number \| string \| null	Highest member price in major units.

FbaInboundPlanStatus可选值 · 3

The live plan state, read through ELTA's amazon.seller.fba_inbound_plan_status lookup.

可选值: ACTIVEVOIDEDCLOSED

FbaInboundStage可选值 · 7

Where one FBA inbound plan is; the kind's pure stage(...) derives it on every read.

可选值: DRAFTCREATE_PENDINGCREATE_UNKNOWNPACKING_DRAFTPACKING_PENDINGPACKEDCANCELLED

FeatureValue5

One windowed analyzed metric, distinct from label adoption counts.

`featureCode`必填string	Code of the analyzed feature this value measures.
`windowDays`必填integer	Length in days of the window the value was computed over.
`value`必填number	The feature's value inside this window.
`velocity`可选number \| null	Change of the value against the previous window; null when none was measured.
`rank`可选integer \| null	Position inside the compared cohort; null when no cohort applies.

FieldProblem3

One provider validation detail attached to a submitted field or whole action row.

`field`可选string \| null	JSON pointer into the change, when known.
`code`必填string	Provider or contract field-problem code.
`message`必填string	Provider explanation and repair guidance.

FiledBatch4

Pointers and selected row keys for one filing; no copy of ELTA or inbox state.

`proposalId`必填string
`inboxItemId`必填string
`revision`必填integer
`rowKeys`必填string[]	Forward selection, or a revert's source-row bound. ELTA revert links and outcomes define touched coverage.

FilingIntent4

Persist one exact proposal or revert request before filing it through approvals.

`request`必填ActionBatch \| RevertRequest
`replayKey`必填string
`commandReceipt`可选CommandReceipt \| null
`revision`必填integer

FillField2

Override value: a shape layer's fill, solid or gradient (None = no fill).

`field`可选string	可选值: `FILL` 默认: `"FILL"`
`fill`必填Color \| BrandColorRef \| LinearGradient \| RadialGradient \| null

FirstLegLineDetail3

Transport composition of the first-leg shipping breakdown line.

`shippingMode`必填ShippingMode
`billableWeightKg`必填number
`ratePerKg`必填MinorUnitMoney

FlipField3

Override value: an image layer's mirror flags.

`field`可选string	可选值: `FLIP` 默认: `"FLIP"`
`flipX`必填boolean
`flipY`必填boolean

FontField2

Override value: a text layer's font.

`field`可选string	可选值: `FONT` 默认: `"FONT"`
`font`必填string \| BrandFontRef

FontSizeField2

Override value: a text layer's font size in canvas pixels.

`field`可选string	可选值: `FONT_SIZE` 默认: `"FONT_SIZE"`
`size`必填number

FontWeight可选值 · 3

The static weights available in the hosted, licence-cleared font manifest.

可选值: REGULARMEDIUMBOLD

FontWeightField2

Override value: a text layer's font weight.

`field`可选string	可选值: `FONT_WEIGHT` 默认: `"FONT_WEIGHT"`
`weight`必填FontWeight

FrameEvidence3

The frame ONE element cites as its evidence.

`kind`可选string	Evidence discriminator; always FRAME. 可选值: `FRAME` 默认: `"FRAME"`
`frame`必填ContentRef	Content reference of the retained frame this element cites.
`timestampMs`必填integer	Publication-relative offset of the cited frame in milliseconds.

Freshness6

Cached freshness rows and one scope-level pending-ingest count.

`object`必填string	Public object discriminator. 可选值: `freshness`
`rows`必填FreshnessRow[]	One freshness aggregate per channel and kind.
`activationEpoch`必填integer	Visible activation epoch.
`activatedAt`必填string	Activation timestamp of the epoch.
`asOf`必填string	Timestamp at which the report was computed.
`ingestPending`可选integer \| null	Jobs waiting in this scope's DP ingest queue; null means not measured.

FreshnessRow6

One freshness aggregate identified by (channel, node_kind).

`channel`必填Channel \| null	Channel this row counts; null for channel-agnostic rows.
`nodeKind`必填NodeKind \| ConceptKind	Node or concept kind this row counts.
`records`必填integer	Number of cached records for this (channel, kind) coordinate.
`latestObservedAt`必填string \| null	Legacy raw observation maximum; not a confirming-check guarantee.
`latestCheckedAt`可选string \| null
`basis`可选FreshnessTime \| null

FreshnessTime可选值 · 3

The three distinct record clocks; no legacy observation fallback is lawful.

可选值: SOURCE_CHANGEDLAST_CHECKEDLAST_NEW_VALUE

FromObject9

The source object or source facts from which a path begins.

`kind`必填NodeKind	Node kind the path starts from.
`channel`可选Channel \| null	Source channel the source records live in; null for derived kinds.
`sourceIds`可选NodeRef[]	Exact source records the path starts from. 默认: `[]`
`descriptions`可选KeywordTerm[]	Descriptive facts (title, brand, handle and similar) hydrated from the source. 默认: `[]`
`identities`可选ExternalIdentity[]	Universal product aliases (GTIN, EAN, UPC, SKU, model number) carried by the source. 默认: `[]`
`handles`可选string[]	Creator or store handles supplied as source facts. 默认: `[]`
`conceptKind`可选ConceptKind \| null	Concept kind to start from when the source kind is CONCEPT.
`market`可选string \| null	Market the source records belong to.
`dateWindow`可选DateWindow \| null	Inclusive publication-date span of source topic videos; null means unbounded.

GapKind可选值 · 7

ONE gap vocabulary for coverage notes and empty step causes.

可选值: UNLINKED_CLAIMSUNHYDRATED_ENDPOINTSMISSING_OBSERVATIONSCELL_EMPTYNO_MATCHNO_INPUTUPSTREAM_EMPTY

GatewayError8

The one customer error body: a stable code, a localized message and the offending fields.

`object`可选string	可选值: `error` 默认: `"error"`
`code`必填GatewayErrorCode
`message`必填string
`fields`可选string[]	默认: `[]`
`failureRef`可选FailureRef \| null	Upstream failure reference for operator lookup.
`operationId`可选string \| null	The call's operation id (also the X-Keble-Operation-Id header); quote it to support.
`redeemRefusalReason`可选RedeemCodeRefusalReason \| null	Finite redeem-refusal reason; set only on a redeem-code refusal.
`retryAfterSeconds`可选integer \| null	Seconds until a retry may succeed (the request window reset); null when unknown.

GatewayErrorCode可选值 · 26

Every customer/admin refusal code on REST, MCP and the V3 feature routes.

可选值: INVALID_API_KEYSIGNED_IN_ONLYACCOUNT_DISABLEDLAST_ORG_OWNERORG_DELETE_BLOCKEDIDENTITY_VERIFICATION_REQUIREDINVALID_REQUESTNOT_FOUNDSTATE_CONFLICTACCESS_REFUSEDINVALID_QUERYRATE_LIMITEDINSUFFICIENT_BALANCEFEATURE_UNAVAILABLESTORE_PLAN_REQUIREDSTORE_SLOT_LIMITSTORE_TOP_UP_REQUIREDSTORE_CHANGE_IN_PROGRESSAPPROVAL_EXPIREDUPGRADE_REQUIREDLEGACY_PLANTRYOUT_LIMIT_REACHEDFREE_ALLOWANCE_UNAVAILABLEUPSTREAM_UNAVAILABLEUPSTREAM_FAILEDTIMED_OUT

GenerateDecor6

Paid: paint one decoration on transparency (§6).

`action`可选string	可选值: `GENERATE_DECOR` 默认: `"GENERATE_DECOR"`
`objectId`必填string
`prompt`必填string
`newLayerId`可选string \| null
`box`可选Box \| null
`replaces`可选string \| null

GenerateFromPlan3

Create one variant per plan row that has none (id {plan_id}-{row_id}); row_ids=None = every such row.

`action`可选string	可选值: `GENERATE_FROM_PLAN` 默认: `"GENERATE_FROM_PLAN"`
`planId`必填string
`rowIds`可选string[] \| null

GenerateScene7

Paid: generate a BACKGROUND under the product layer, or across the whole canvas, from a prompt.

`action`可选string	可选值: `GENERATE_SCENE` 默认: `"GENERATE_SCENE"`
`designId`必填string
`layerId`必填string \| null
`newLayerId`可选string \| null
`replaces`可选string \| null
`prompt`必填string
`styleReferences`可选AssetRef[]	默认: `[]`

GeometryField2

Override value: a shape layer's whole geometry (a variant may round a panel or swap a badge outline).

`field`可选string	可选值: `GEOMETRY` 默认: `"GEOMETRY"`
`geometry`必填RectGeometry \| EllipseGeometry \| LineGeometry \| PolygonGeometry \| PathGeometry

GradientStop2

One colour at offset 0–1, following a kit or literal colour.

`offset`必填number
`color`必填Color \| BrandColorRef

GrantedBy可选值 · 2

Who can grant a permission, which decides who must act when it is missing.

可选值: OWNERAPP

GridSpec5

Which measures may size the circle and be printed in it.

`sizeMeasures`必填string[]
`numberMeasures`必填string[]
`defaultSize`必填string
`defaultNumber`必填string
`cellAssessments`可选string[]	默认: `[]`

GroupLayer8

Layers moved and hidden together; children are placed in canvas coordinates and the box is derived.

`layerId`必填string
`name`必填string
`opacity`可选number	默认: `1`
`blendMode`可选BlendMode	默认: `"NORMAL"`
`visible`可选boolean	默认: `true`
`locked`可选boolean	默认: `false`
`kind`可选string	可选值: `GROUP` 默认: `"GROUP"`
`children`必填ImageLayer[] \| TextLayer[] \| ShapeLayer[] \| GroupLayer[]

GroupLayers5

Wrap sibling layers into a new group (caller-minted id); its box is derived from them.

`action`可选string	可选值: `GROUP_LAYERS` 默认: `"GROUP_LAYERS"`
`designId`必填string
`layerIds`必填string[]
`groupId`必填string
`name`必填string

GuardedFetchRefusalCode可选值 · 7

Why a guarded fetch was refused; each is a policy decision, never a transport fault.

可选值: NOT_HTTPSBLOCKED_ADDRESSTOO_MANY_REDIRECTSBAD_STATUSCONTENT_TYPE_NOT_ALLOWEDTOO_LARGETIMEOUT

HeadingBlock3

One section heading (h2/h3); the post title is the h1 and is not a block.

`kind`可选string	可选值: `HEADING` 默认: `"HEADING"`
`level`必填integer	可选值: `23`
`text`必填string

HopProgress6

ONE public step entry: how far a page's step got.

`edgeId`可选string \| null	Public catalog edge id; null when unavailable (direct searches or older records).
`toKind`必填NodeKind	Node kind this step reads.
`read`必填integer	Rows this step read so far.
`fetched`可选integer \| null	Rows this step fetched before a post-fetch filter removed some; null when no rows were removed after fetching.
`exhausted`必填boolean	True when this step has no further rows.
`emptyCause`可选GapKind \| null	Why this step read zero rows; null unless read is 0.

HostedImage5

One exact exported design with its private-storage signed GET URL and its slot findings.

`designId`必填string
`asset`必填AssetRef
`url`必填string
`expiresAt`必填string
`findings`必填SlotFinding[]

HtmlSegment1

One literal HTML fragment in the ordered body sent to Shopify.

html必填string

HttpsImageUrl1

An image the owner already hosts (their own cloud link); Amazon fetches it at apply.

url必填string

ImageBlock3

One shape-selected image placed between paragraphs, with an optional caption.

`kind`可选string	可选值: `IMAGE` 默认: `"IMAGE"`
`image`必填ExistingShopifyFile \| ShopifyRemoteImage \| PostExportedImage
`caption`可选string \| null

ImageExportRef3

The consumer-held reference to one exported design: set, immutable export, design.

`imageSetId`必填string
`exportId`必填string
`designId`必填string

ImageFill2

Fill an image placeholder with an asset (the product photo, a logo); never a found REFERENCE.

`placeholder`必填string	可选值: `bodycallout_1callout_2callout_3headlineproduct_photo`
`asset`必填AssetRef

ImageFinding2

One slot-rule result placed on one image of the draft; a hint, never a refusal.

`pointer`必填string
`finding`必填SlotFinding

ImageLayer15

A placed image; mask is a cut-out alpha matte applied to asset's own pixels.

`layerId`必填string
`name`必填string
`opacity`可选number	默认: `1`
`blendMode`可选BlendMode	默认: `"NORMAL"`
`visible`可选boolean	默认: `true`
`locked`可选boolean	默认: `false`
`box`必填Box
`shadow`可选DropShadow \| null
`kind`可选string	可选值: `IMAGE` 默认: `"IMAGE"`
`role`必填ImageRole
`asset`必填AssetRef
`mask`可选AssetRef \| null
`flipX`可选boolean	默认: `false`
`flipY`可选boolean	默认: `false`
`crop`可选Box \| null

ImageMediaType可选值 · 3

Accepted and produced image encodings.

可选值: image/pngimage/jpegimage/webp

ImageOperation可选值 · 3

The paid image-model operations; each is one OperationSpec in library.OPERATIONS.

可选值: CUT_OUTSCENEDECOR

ImageRole可选值 · 4

What an image layer shows; the fidelity law and the slot checks read it.

可选值: PRODUCTBACKGROUNDDECORATIONLOGO

InboxItemRef1

Which inbox item a read or completion names (one tool/route input).

itemId必填string

InboxPendingRequest2

One pending page: an opaque cursor and a bounded size (one tool/route input).

`cursor`可选string \| null
`limit`可选integer	默认: `20`

InferredFact2

WHERE A RETURNED VALUE CAME FROM when it was inferred.

`inferredBy`必填string	Declaration and major that inferred the value, e.g. creator_market@1.
`confidence`必填number	The inference's confidence in [0, 1].

IntakeFinding2

One hint on one accepted upload (index into the uploads tuple).

`code`必填IntakeFindingCode
`uploadIndex`必填integer

IntakeFindingCode可选值 · 1

A hint about an accepted upload; the owner decides whether it suits their slot.

可选值: TOO_SMALL

IntakeRefusal4

An upload the intake refused (index into the uploads tuple), with the limits in force on TOO_LARGE.

`code`必填IntakeRefusalCode
`uploadIndex`必填integer
`maxUploadBytes`可选integer \| null
`maxPixels`可选integer \| null

IntakeRefusalCode可选值 · 2

Why an upload was not accepted: only bytes that cannot be an image or cannot be stored.

可选值: NOT_AN_IMAGETOO_LARGE

IssueKind可选值 · 7

Why a provider refused or failed one call, in the terms the service acts on.

可选值: AUTH_INVALIDPERMISSION_MISSINGACCOUNT_UNAVAILABLERATE_LIMITEDPROVIDER_UNAVAILABLEREQUEST_REJECTEDNOT_FOUND

ItemAction2

Host-defined alert remedy, such as a store reason and its store identity.

`key`必填string
`ref`必填string

ItemCardSpec4

How one item group is shown in the item list and approval step.

`titleFact`必填string
`imageFact`可选string \| null
`facts`可选string[]	默认: `[]`
`pivotFacts`可选string[]	默认: `[]`

ItemContent4

Human-visible and editable todo/alert/approval content.

`title`必填string
`description`可选string	默认: `""`
`priority`可选Priority	默认: `"NORMAL"`
`assignee`可选string \| null

ItemPrompt2

What the models see of one item, as typed parts.

`text`必填string
`imageUrls`可选string[]	默认: `[]`

ItemRead2

One item with its relevance and its group's placements (what the SOURCE and PLACE reviews show).

`record`必填ItemRecord
`placements`必填object

ItemRecord2

One stored item, as the plugin sourced it or a caller added it, with its relevance.

`item`必填SourcedItem
`relevant`必填boolean

ItemUpdate4

One item's changed fields; an omitted field is unchanged, a named fact is replaced.

`key`必填string
`name`可选string \| null
`facts`可选object
`relevant`可选boolean \| null

ItemsDetailValue4

An ITEMS detail row: the cell's sample items projected to the declared facts.

`object`可选string	可选值: `items_detail_value` 默认: `"items_detail_value"`
`kind`可选string	可选值: `ITEMS` 默认: `"ITEMS"`
`key`必填string
`items`可选object[]	默认: `[]`

ItemsRow2

A detail row listing the cell's sample items with the named facts.

`kind`可选string	可选值: `ITEMS` 默认: `"ITEMS"`
`facts`必填string[]

JsonValue0

没有字段。

JudgmentAdjustment4

Rewrite the conclusion text of the head revision; numbers untouched, 0 model calls.

`adjustmentType`可选string	可选值: `JUDGMENT` 默认: `"JUDGMENT"`
`verdict`可选ReportJudgmentVerdict \| null	Replacement verdict, when given.
`sections`可选ReportJudgmentSection[]	Replacement slot texts, each slot at most once. 默认: `[]`
`overview`可选ReportOverviewEvidence \| null	Replacement overview, when given.

JudgmentQuestion8

Write the conclusion for the committed numbers of one revision.

`decisionType`可选string	可选值: `JUDGMENT` 默认: `"JUDGMENT"`
`language`必填Language	Reader language of every text.
`verdictOpen`必填boolean	False: a policy pre-check already fixed the verdict.
`fixedReasonCode`可选ReportReasonCode \| null	Set iff the verdict is not open.
`materialInputUnresolvedAdmissible`必填boolean	Whether MATERIAL_INPUT_UNRESOLVED may be the reason.
`ruleLines`可选string[]	Policy rules the verdict must follow. 默认: `[]`
`sectionKinds`必填ReportNarrativeSectionKind[]	The section slots to write, once each.
`items`可选ReportJudgmentEvidenceItem[]	Citable accepted artifacts. 默认: `[]`

KebleBlockKind可选值 · 2

The block kinds a Keble section may repeat: one FAQ question, one feature of a feature list.

可选值: QUESTIONFEATURE

KebleSectionKind可选值 · 5

The v1 Keble section library; every member has exactly one SectionSpec (totality test).

可选值: HERO_BANNERRICH_TEXTIMAGE_WITH_TEXTFAQFEATURE_LIST

Keyword11

Represent a market-scoped source term without embedding product relations.

`kind`可选string	可选值: `KEYWORD` 默认: `"KEYWORD"`
`channel`必填Channel
`externalId`必填string
`text`必填string
`keywordType`可选KeywordType	默认: `"SEARCH_TERM"`
`market`可选string \| null
`metrics`可选MetricObservation[]	默认: `[]`
`brands`可选string[]	默认: `[]`
`categories`可选string[]	默认: `[]`
`observedAt`必填string
`provenance`必填Provenance

KeywordCandidate2

One caller term with the evidence the server attached (the core's one converter builds it).

`term`必填string
`evidence`必填MeasuredKeywordEvidence[] \| SuggestedKeywordEvidence[]

KeywordTerm2

A normalized description carried from a source into ONE named builder.

`value`必填string	The normalized description text.
`termType`必填SourceDescriptionKind	Which descriptive source field the text came from.

KeywordType可选值 · 3

Describe a source term without selecting its eventual query operation.

可选值: SEARCH_TERMHASHTAGTAG

KindRuleProblem4

One kind-owned rule a row's action breaks, located by JSON Pointer in action.change.

`rowKey`必填string
`pointer`必填string
`rule`必填string
`message`必填string

KitColor4

One named kit colour.

`entryId`必填string
`name`必填string
`color`必填Color
`replacedBy`可选string \| null

KitFont3

One named kit font with its usage label, e.g. Anton for HEADLINES (demo 4). Weight stays on the layer.

`entryId`必填string
`name`必填string
`font`必填string	可选值: `intermontserratnoto_sans_scnoto_serif_scplayfair_display`

Language可选值 · 22

可选值: ENGLISHSIMPLIFIED_CHINESEGERMANFRENCHITALIANSPANISHDUTCHPORTUGUESEJAPANESETURKISHPOLISHSWEDISHARABICHINDITHAIKOREANVIETNAMESEINDONESIANHEBREWNORWEGIANDANISHFINNISH

LastCombine1

Range value = the value of the last day that has one.

kind可选string

Range combination: last day with a value.

可选值: last

默认: "last"

LayerClippedRule1

No visible layer extends past the canvas edge (advisory).

kind可选string

可选值: LAYER_CLIPPED

默认: "LAYER_CLIPPED"

LayerField可选值 · 19

One editable field of a layer or of the canvas.

可选值: BOXTEXTCOLORFONTFONT_SIZEFONT_WEIGHTALIGNLINE_HEIGHTLETTER_SPACINGFILLSTROKEGEOMETRYSHADOWOPACITYBLENDVISIBLEFLIPCROPBACKGROUND

LayerOverride3

One field of one variant layer that differs from the parent; latest write per (layer_id, field) wins.

`layerId`必填string \| null
`value`必填BoxField \| TextField \| ColorField \| FontField \| FontSizeField \| FontWeightField \| AlignField \| LineHeightField \| LetterSpacingField \| FillField \| StrokeField \| GeometryField \| BlendField \| ShadowField \| OpacityField \| VisibleField \| FlipField \| CropField \| BackgroundField
`atRevision`必填integer

LeafEditability可选值 · 3

How a page or agent may change one leaf of a row's change; derived from ELTA facts.

可选值: NOT_EDITABLEEDITABLEPRIVATE_WRITE_ONLY

LeafRule3

One editability fact for one action type at one JSON Pointer into change.

`actionTypeKey`必填string
`pointer`必填string
`editability`必填LeafEditability

LetterSpacingField2

Override value: a text layer's letter spacing.

`field`可选string	可选值: `LETTER_SPACING` 默认: `"LETTER_SPACING"`
`letterSpacing`必填number

LineGeometry2

A line across the box diagonal or midline (callout leader lines).

`kind`可选string	可选值: `LINE` 默认: `"LINE"`
`diagonal`可选boolean	默认: `false`

LineHeightField2

Override value: a text layer's line height.

`field`可选string	可选值: `LINE_HEIGHT` 默认: `"LINE_HEIGHT"`
`lineHeight`必填number

LinearGradient3

A fill across the box: angle 0 left-to-right, 90 top-to-bottom; rotates with the box.

`stops`必填GradientStop[]
`gradient`可选string	可选值: `LINEAR` 默认: `"LINEAR"`
`angle`可选number	默认: `90`

ListBlock3

One bulleted or numbered list; items use the paragraph's inline subset.

`kind`可选string	可选值: `LIST` 默认: `"LIST"`
`ordered`必填boolean
`items`必填string[]

ListingCapture1

A dataset read as the full current list on every run.

kind可选string

Capture style: full current list.

可选值: listing

默认: "listing"

ListingContent6

The seller-editable draft: PTD attributes, price, keyword terms and ordered images.

`sellerSku`必填string
`attributes`可选object
`ourPrice`可选number \| string \| null
`keywords`可选string[]	默认: `[]`
`mainImage`可选ImageExportRef \| OwnedPhotoRef \| HttpsImageUrl \| null
`otherImages`可选ImageExportRef[] \| OwnedPhotoRef[] \| HttpsImageUrl[]	默认: `[]`

ListingCreate3

Create one owner-fenced draft for one target; the body never carries an account.

`replayKey`必填string
`target`必填ListingTarget
`content`必填ListingContent

ListingOutcome可选值 · 8

What happened to the draft's ADD, derived on every read from the live approval and ELTA reads.

可选值: NOT_FILEDAWAITING_APPROVALREJECTEDUNKNOWNNOT_YET_LISTEDLISTEDREVERT_PENDINGREMOVED

ListingReadBack3

ELTA's live read of the exact seller SKU after an applied ADD.

`sellerSku`必填string
`present`必填boolean
`asin`可选string \| null

ListingSnapshot15

The owner-visible draft at one revision with its pins, evidence, checks and live outcome.

`artifectRef`必填ArtifectRef
`revision`必填integer
`account`必填AccountRef
`productTypeSchema`必填ProductTypeSchema
`content`必填ListingContent
`keywordCandidates`可选KeywordCandidate[]	默认: `[]`
`screening`必填ScreeningResult
`imageFindings`可选ImageFinding[]	默认: `[]`
`preview`可选RowPreview \| null
`stage`必填ChangeListStage
`guide`必填StageGuide
`outcome`必填ListingOutcome
`approval`可选ApprovalState \| null
`revertApproval`可选ApprovalState \| null
`readBack`可选ListingReadBack \| null

ListingStatus可选值 · 4

Name the known availability states of one Product listing.

可选值: ACTIVEUNPUBLISHEDREMOVEDUNKNOWN

ListingTarget3

The ELTA store, its selected marketplace account and the product type of one draft.

`storeId`必填string
`marketplaceId`必填string
`productType`必填string

LlmProductDiversity可选值 · 4

可选值: STANDARDIZED_WITH_STRICT_PROTOCOLSFUNCTION_PRIORITIZED_OVER_DESIGN_AND_DESIGN_DOES_NOT_AFFECT_PURCHASE_DECISIONFUNCTION_PRIORITIZED_OVER_DESIGN_BUT_DESIGN_AFFECT_PURCHASE_DECISIONDESIGN_IMPORTANCE_TO_CONSUMERS

Lookup6

One live provider read a source supports: answered on request, never stored.

`key`必填string	Live lookup identifier.
`title`必填string	Display name of this live lookup.
`querySchema`必填JsonValue	JSON Schema of the lookup input.
`resultSchema`必填JsonValue	JSON Schema of a lookup result.
`requires`可选Permission[]	Permissions needed to run this lookup. 默认: `[]`
`meaning`可选string \| null	What this live lookup answers and when to use it, in one sentence; null when undeclared.

LookupPage3

One bounded page of live results; next_cursor is the provider's page token.

`object`可选string	Fixed tag marking this object as a lookup page. 可选值: `lookup_page` 默认: `"lookup_page"`
`rows`必填JsonValue[]	The result rows in the lookup's own shape.
`nextCursor`可选string \| null	Cursor continuing to the next page; none on the last page.

LookupRequest5

One live read pinned to an owner-visible store and optional stored account.

`storeId`必填string	Owner-visible store to read.
`lookupKey`必填string	The declared lookup to run.
`accountId`可选string \| null	Stored account to read; required when the source has several.
`query`必填JsonValue	The lookup's own query payload.
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

MatchedFact11

WHY THIS ROW MATCHED THIS CLAUSE: the stored fact, when it was observed, and the relation path if a hop was involved. One fact per field, one MatchedFact per clause.

`clauseIndex`可选integer \| null	Index of the query clause this fact satisfies; null when the fact carries no clause position.
`basis`必填EvidenceBasis	Evidence basis of this fact: RECORDED, MENTIONED or SIMILAR.
`fieldOrCode`必填string	Field or feature code the fact was read from.
`value`必填string \| integer \| number \| string \| boolean	The stored value that matched the clause; money is an exact major-unit decimal.
`observedAt`必填string \| null	When the fact was observed; null when unknown.
`measure`可选string \| null	Trend column the fact read: VALUE, VELOCITY or RANK; null when the fact is not a feature.
`path`可选RelationHop[]	Relation hops that connect the result to the fact; empty when the match needed none. 默认: `[]`
`window`可选ResolvedWindow \| null	The resolved window this fact was read in; null when the fact carries none.
`currencyBasis`可选CurrencyBasis \| null	How a monetary fact's currency is known (STATED or ASSUMED); null for a non-monetary fact.
`estimation`可选EstimationStatus \| null	Whether a monetary fact's value is estimated; null for a non-monetary fact.
`inferred`可选InferredFact \| null	Provenance of an inferred value; omitted when the source stated the value.

MaterialFactEstimate2

Use the system calculation for one key, without claiming seller authority.

`choiceType`可选string	可选值: `ESTIMATE` 默认: `"ESTIMATE"`
`questionKey`必填string	Question settled by system estimation.

MaterialFactResolution3

One seller-fact choice for one committed material question.

`choiceType`可选string	可选值: `RESOLUTION` 默认: `"RESOLUTION"`
`questionKey`必填string	Answered question identity.
`resolution`必填ReportMaterialResolution	Typed seller facts.

MaterialFactsAnswer2

Settle offered material keys in one non-empty, typed request.

`decisionType`可选string	可选值: `MATERIAL_FACTS` 默认: `"MATERIAL_FACTS"`
`resolutions`必填MaterialFactResolution[] \| MaterialFactEstimate[]	One resolution or estimate choice per offered key.

Maturity可选值 · 2

Whether a day's value may still be restated by the source.

可选值: PROVISIONALFINAL

MaxLongestSideRule2

The longest side is at most pixels (Shopify 5000, Amazon 10000).

`kind`可选string	可选值: `MAX_LONGEST_SIDE` 默认: `"MAX_LONGEST_SIDE"`
`pixels`必填integer

Measure3

One declared numeric column, its unit and its display name.

`key`必填string	Numeric-column identifier; fact queries use its declared row path.
`unit`必填Unit	Physical unit of values in this column.
`title`必填StoreLocalizedText	Display name of the column, in both languages.

MeasureChange7

One measure changed; values stay Decimal and an absent side is None, never 0.

`entity`必填string	Stored entity key of the row that changed.
`observedAt`必填string	Instant the new value became readable.
`captureId`必填string	The capture that made the new value readable.
`kind`可选string	Discriminator marking this as a measure change. 可选值: `measure` 默认: `"measure"`
`measureKey`必填string	The declared measure whose value changed.
`oldValue`可选number \| string \| null	The value before the change; none when there was none.
`newValue`可选number \| string \| null	The value after the change; none when there was none.

MeasureCoverage2

How many of the cell's groups (or items) carried the measured fact.

`counted`必填integer
`total`必填integer

MeasureDetailValue4

A MEASURE detail row: one declared measure's computed value for the cell.

`object`可选string	可选值: `measure_detail_value` 默认: `"measure_detail_value"`
`kind`可选string	可选值: `MEASURE` 默认: `"MEASURE"`
`key`必填string
`measure`可选MeasureValue \| null

MeasureFormat可选值 · 4

How the frontend prints a measure value.

可选值: INTEGERDECIMALMONEYPERCENT

MeasureRow2

A detail row showing one measure's value.

`kind`可选string	可选值: `MEASURE` 默认: `"MEASURE"`
`measure`必填string

MeasureValue4

One measure's value in one cell; coverage is set for DISTINCT and fact-based rules.

`status`必填ValueStatus
`value`可选number \| string \| null
`currency`可选string \| null
`coverage`可选MeasureCoverage \| null

MeasuredKeywordEvidence8

One ELTA fact row the server read for this term: family, account, day, row identity, metric.

`kind`可选string	可选值: `MEASURED` 默认: `"MEASURED"`
`familyKey`必填string
`accountId`必填string
`day`必填string
`sourceRowId`必填string
`sourceRowSha256`必填string
`measureKey`必填string
`value`必填number \| string

MediaKind可选值 · 2

Name the common image or video media forms carried by entities.

可选值: IMAGEVIDEO

MediaRef6

Reference one public media URL without carrying its bytes.

`kind`必填MediaKind
`sourceUrl`必填string
`thumbnailUrl`可选string \| null
`width`可选integer \| null
`height`可选integer \| null
`durationSeconds`可选number \| null

Metric5

One metric the plugin calculates per day, and how its days are combined.

`key`必填string	Calculated metric identifier.
`unit`必填Unit	Physical unit of the metric's values.
`levels`必填string[]	Granularities where this metric is available.
`meaning`必填string	Business meaning of this metric.
`combine`必填Combine	How daily values combine across a reporting range.

MetricClause4

Compare one typed metric against an integer, finite number, or Money.

`kind`可选string	可选值: `METRIC` 默认: `"METRIC"`
`metric`必填MetricKind
`op`必填string	可选值: `GTELTE`
`value`必填integer \| number \| MinorUnitMoney

MetricCoverage可选值 · 5

Describe whether a metric is a point, interval, cumulative, or board fact.

可选值: POINTINTERVALCUMULATIVEBOARDUNKNOWN

MetricGap可选值 · 7

Why a range value is missing or qualified.

可选值: NOT_CAPTUREDSOURCE_BLOCKEDINCOMPLETENOT_MEASURABLEMIXED_CURRENCYMIXED_TIMEZONERECALCULATING

MetricKind可选值 · 46

Name entity and product-keyword measurements with stable units and periods.

可选值: sales_quantitygmvorder_countratingreview_countrankvideo_countfollower_countcreator_countview_countlike_countcomment_countshare_countsave_countscoreupvote_ratiofollowing_countpost_countreply_countproduct_countestimated_visitspricelist_priceoffer_countorganic_traffic_scoreadvertising_traffic_scoretotal_traffic_scoreorganic_search_term_countadvertising_search_term_countsearch_volumecompetitive_difficultyorganic_rotation_rateclick_conversion_ratecost_per_clicksearch_frequency_rankorganic_trafficadvertising_traffictotal_trafficorganic_traffic_acquisition_rateadvertising_traffic_acquisition_ratetotal_traffic_acquisition_ratetraffic_ratioclick_shareconversion_sharekeyword_intersectionsavg_search_position

MetricObservation16

Represent one typed measurement without source/provider attribution.

`metric`必填MetricKind
`unit`必填MetricUnit
`period`必填MetricPeriod
`intValue`可选integer \| null
`floatValue`可选number \| null
`moneyValue`可选MinorUnitMoney \| null
`currencyBasis`可选CurrencyBasis \| null
`market`可选string \| null
`measuredAt`可选string \| null
`periodStart`可选string \| null
`periodEnd`可选string \| null
`coverage`可选MetricCoverage	默认: `"UNKNOWN"`
`estimationStatus`可选EstimationStatus	默认: `"UNKNOWN"`
`confidence`可选number \| null
`origin`可选ObservationOrigin	默认: `"CAPTURED"`
`change`可选boolean	默认: `false`

MetricPage5

One bounded page of combined range values: the /v2/metrics/query response.

`rows`必填MetricRangeValue[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Fixed tag marking this object as a metric page. 可选值: `metric_page` 默认: `"metric_page"`

MetricPeriod可选值 · 6

Name the temporal coverage of a metric observation.

可选值: CURRENTD7D30LIFETIMEWEEKMONTH

MetricRangeValue11

One metric for one entity over the requested days, combined by its declared rule.

`metricKey`必填string	The metric this value is for.
`entity`必填string	The entity these days were combined for.
`value`必填number \| string \| null	The combined value; none means no value, not zero.
`availability`必填Availability	What is held for this metric, entity and range.
`maturity`必填Maturity	Whether the combined days may still be restated.
`currency`可选string \| null	Currency of the value when it is money; none otherwise.
`timezone`可选string \| null	Timezone the days were read in, when combining needs it.
`accountId`可选string \| null	Set only when the value could not be combined across accounts.
`gaps`可选MetricGap[]	Reasons the value is missing or qualified. 默认: `[]`
`provisionalDays`可选string[]	Days in the range that may still be restated. 默认: `[]`
`blocked`可选BlockedLane[]	Lanes named with a source-blocked gap: which and why. 默认: `[]`

MetricUnit可选值 · 6

THE one unit vocabulary for metric values; DPC imports it.

可选值: COUNTMONEYRATIORATINGSCOREDURATION_MS

MetricsRequest7

A serving read of one or more metrics over a date range, current values only.

`metricKeys`必填string[]	Metrics to read; at least one.
`level`必填string	The entity level key the caller wants values at.
`days`必填DayRange	Inclusive reporting days in the account's timezone.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to read; empty means every account of the owner. 默认: `[]`
`entities`可选string[]	Stored entity keys to read; empty means every entity. 默认: `[]`
`page`可选PageRequest	Row limit and cursor for this read. 默认: `{"limit":200}`

MinLongestSideRule2

The longest side is at least pixels (Amazon: 1000 enables zoom).

`kind`可选string	可选值: `MIN_LONGEST_SIDE` 默认: `"MIN_LONGEST_SIDE"`
`pixels`必填integer

Monitor13

One user-owned standing question with its watches, schedule and delivery.

`monitorId`必填string
`owner`必填MonitorOwnerScope
`confirmedBy`可选string \| null
`title`必填string
`language`可选Language	默认: `"ENGLISH"`
`status`必填MonitorStatus
`pauseReason`可选MonitorPauseReason \| null
`specRevision`必填integer
`watches`可选MonitorWatch[]	默认: `[]`
`cadence`可选MonitorCadence \| null
`delivery`可选MonitorDelivery	默认: `{"chat":true,"email":false}`
`agent`必填MonitorAgentBinding
`nextDueAt`可选string \| null

MonitorCadence6

One schedule; next_due is the only schedule math in the estate.

`unit`必填MonitorCadenceUnit
`every`必填integer
`at`可选string \| null
`weekday`可选integer \| null
`dayOfMonth`可选integer \| null
`timezone`必填string

MonitorConfirmPage6

The confirm input page, "What we'll monitor": watches, schedule, next run and the request estimate.

`page`可选string	可选值: `CONFIRM` 默认: `"CONFIRM"`
`monitor`必填Monitor
`nextRunAt`必填string
`checksPerDay`必填number \| string
`requestsPerDay`必填number \| string
`expiresAt`必填string

MonitorCycle10

One scheduled check of one monitor, running the frozen spec_revision.

`monitorId`必填string
`seq`必填integer
`specRevision`必填integer
`dueAt`必填string
`state`必填MonitorCycleState
`watches`必填MonitorWatchCycle[]
`baseline`必填boolean
`startedAt`必填string
`finishedAt`可选string \| null
`deliveries`可选MonitorChannelDelivery[]	默认: `[]`

MonitorDelivery2

Per-monitor channel toggles; the inbox notification is always filed for a reported cycle.

`chat`可选boolean	默认: `true`
`email`可选boolean	默认: `false`

MonitorFinding3

One reported item of one cycle: the item as seen, and what changed.

`findingKey`必填MonitorFindingKey
`item`必填MonitorFindingItem
`change`必填MonitorNewItem \| MonitorValueChange \| MonitorRankMove

MonitorSetupPage5

The setup input page: the capability catalog frozen at create, and the cadence floor.

`page`可选string	可选值: `SETUP` 默认: `"SETUP"`
`monitor`必填Monitor
`offers`必填MonitorCapabilityOffer[]
`minInterval`必填string
`expiresAt`必填string

MonitorSnapshot3

What the host reads to show a monitor and derive its artifect stage (from status + open cycle only).

`monitor`必填Monitor
`openCycle`可选MonitorCycle \| null
`lastCycle`可选MonitorCycle \| null

MonitorStatus可选值 · 5

Lifecycle of one monitor; the artifect stage is derived from it and the open cycle, never stored.

可选值: SETTING_UPAWAITING_CONFIRMACTIVEPAUSEDSTOPPED

MonitorWatch11

One stored watch: the compiled spec under the core's stable watch_key, with the request it came from.

`title`必填string
`channelLabel`必填string
`subjectLabel`必填string
`policy`必填MonitorFindingPolicy
`sourceKey`必填string
`fetches`必填boolean
`minInterval`必填string
`readsPerCheck`必填integer
`dataAsOf`可选string \| null
`watchKey`必填string
`request`必填MonitorWatchRequest

MonthlyStorageFee8

`month`必填integer
`isDangerousGoods`必填boolean
`productSizeTier`必填string
`feeCategory`必填string
`volumeCubic`必填number
`cubicUnit`必填string	可选值: `ftm`
`perCubicStorageFee`必填number
`storageFee`必填number

Motif11

ONE MOTIF NODE — a group of elements several creators independently did.

`kind`可选string	Node discriminator; always MOTIF. 可选值: `MOTIF` 默认: `"MOTIF"`
`key`必填string	Identity key 'motif:{first member element key}'; a merge keeps the older key.
`name`必填string	Display name of the motif.
`elementKind`必填ConceptKind	Concept kind of the elements this motif groups.
`sections`必填MotifSection[]	Named sections this motif belongs to; empty when it belongs to none.
`features`必填FeatureValue[]	Windowed motif figures (creators, posts, quality) with velocity and rank.
`trend`可选MotifTrend \| null	Read-time trending reading over the reader's own window; null when the read names no trending window.
`dailyPosts`必填integer[]	Posts per day across the requested window, oldest first, ending at the window end day; length equals the window's days.
`products`可选RelationRef[]	Distinct products featured by the motif's member content. 默认: `[]`
`membersTotal`必填integer	Number of member elements grouped by this motif.
`examples`可选MotifMember[]	Newest-first member examples, at most five. 默认: `[]`

MotifMember10

ONE member element shown on a motif card.

`elementKey`必填string	Key of the member element inside the motif.
`contentRef`必填NodeRef	Scoped reference to the content the element was extracted from.
`creatorRef`必填NodeRef \| null	Scoped reference to the content's creator; null when it has no author.
`pattern`必填string	Generic pattern label of the element, without brand or product names.
`appearance`必填string	How the element appears: subject, action, framing and on-screen text.
`instance`必填string \| null	This content's brand or product specifics for the pattern; null when none.
`evidence`必填FrameEvidence[] \| SpanEvidence[]	Frame or transcript citations that support this member.
`publishedAt`必填string \| null	Publication time of the member content; null when unknown.
`creatorHandle`可选string \| null	Handle of the member content's creator, when known.
`views`可选integer \| null	Latest view count of the member content, when known.

MotifQuery6

One named motif section and window with an optional row ceiling.

`days`可选integer \| null	Length in days of the current window; null when start/end state the span.
`start`可选string \| null	Inclusive first day of an explicit span.
`end`可选string \| null	Inclusive last day of the current window; null uses the newest member publication day in scope.
`section`必填MotifSection
`terms`可选string[]	Word-match terms tested against each member's label or instance, or the member content's searchable fields; at most eight. 默认: `[]`
`maxRows`可选integer \| null	Optional row ceiling for this motif page; the smaller of this and the normal page size is returned. Omission preserves the normal page size.

MotifSection可选值 · 2

THE TWO NAMED MOTIF QUESTIONS the platform asks of itself on every page load, as a closed vocabulary rather than free text.

可选值: SPREADINGEARLY

MotifTrend8

ONE MOTIF'S TRENDING READING for the resolved window and the equally long window immediately before it.

`score`必填number	Trending score: creators x growth x buzz x freshness.
`growth`必填number	Current creators over previous creators, plus one each; the previous count is 0 when nothing published in the previous window.
`buzz`必填number	Log10(1 + likes + 2 x comments) over the current window.
`freshness`必填number	Recency decay of the newest member publication, in (0, 1].
`ageDays`必填integer	Days from the window's end day back to the newest in-window member publication.
`newestPublishedAt`必填string	Publication time of the newest member inside the current window.
`current`必填MotifWindowFigures	Member figures of the current window.
`previous`可选MotifWindowFigures \| null	Member figures of the equally long previous window; null when nothing published in it.

MotifWindow3

WHICH CALENDAR DAYS one motif trending read compares.

`days`可选integer \| null	Length in days of the current window; null when start/end state the span.
`start`可选string \| null	Inclusive first day of an explicit span.
`end`可选string \| null	Inclusive last day of the current window; null uses the newest member publication day in scope.

MotifWindowFigures5

ONE MOTIF'S MEMBER TOTALS INSIDE ONE WINDOW.

`creators`必填integer	Distinct member creators who published inside the window.
`posts`必填integer	Distinct member contents published inside the window.
`likes`必填integer	Likes summed over the window's member contents; a missing count is 0.
`comments`必填integer	Comments summed over the window's member contents; a missing count is 0.
`views`必填integer	Views summed over the window's member contents; a missing count is 0.

MoveBlock4

Move one block within its section to after another block (None: to the end).

`action`可选string	可选值: `MOVE_BLOCK` 默认: `"MOVE_BLOCK"`
`sectionKey`必填string
`blockKey`必填string
`after`可选string \| null

MoveSection3

Move one section within its page to after another entry (None: to the end).

`action`可选string	可选值: `MOVE_SECTION` 默认: `"MOVE_SECTION"`
`sectionKey`必填string
`after`可选string \| null

NewChangeRow2

A new account-free row action and the one-sentence rationale shown to the person.

`action`必填UnboundAction
`rationale`必填string

NewKeblePage2

The store page Keble creates at publish for a Keble landing-page template (unpublished).

`title`必填string
`handle`必填string

NewThemePage4

Removed in the first theme release after SEO and GEO migrate.

`title`必填string
`handle`必填string
`templateSuffix`必填string
`body`必填HtmlSegment[] \| ExistingShopifyFile[] \| ShopifyRemoteImage[]

NoArguments0

The request of an operation that takes nothing but its caller (a catalog, a freshness report).

没有字段。

NoBadgeClaimsRule1

No visible text layer carries a badge or claim word from the package's fixed zh/en lexicon.

kind可选string

可选值: NO_BADGE_CLAIMS

默认: "NO_BADGE_CLAIMS"

NoEdgeCropRule2

At most max_hidden_ratio of the product's content box is hidden by the canvas edge or a crop.

`kind`可选string	可选值: `NO_EDGE_CROP` 默认: `"NO_EDGE_CROP"`
`maxHiddenRatio`必填number

NoGraphicsRule1

Only product image layers over the background: no shapes, logos or decorations (Amazon main).

kind可选string

可选值: NO_GRAPHICS

默认: "NO_GRAPHICS"

NoTextRule1

The design has no visible text layer (Amazon main image: no text or pricing).

kind可选string

可选值: NO_TEXT

默认: "NO_TEXT"

NodeHit9

A returned typed node, the source refs that led to it, and its display facts.

`item`必填Product \| Store \| Creator \| Content \| Keyword \| Contact \| PlatformDefinedCategory \| Brand \| ProductFamily \| Motif \| Concept	The returned node, either a source entity or a declared derived kind.
`via`可选NodeRef[]	Scoped source references that led to this node. 默认: `[]`
`analysis`可选Analysis \| null	Analyzed facts attached when the analyzed store has them; null otherwise.
`recordKey`必填string	The stored row's key, else stable_key_of over the subject claim.
`familyKey`可选string \| null	Product family key shared by this row's siblings; null when the row belongs to no family.
`evidence`可选MatchedFact[]	Matched facts explaining why this hit is here; at most 8. 默认: `[]`
`promoted`可选boolean	Whether this hit is promoted: a recorded promotional link, or explicit paid sponsorship. When the hit's claim about the matched entity carries a stance, paid sponsorship counts only if that claim recommends the entity as the item's main subject; a hit with no stance-bearing claim keeps the plain paid verdict. Computed once by is_promoted, never re-derived by a renderer. 默认: `false`
`label`可选string \| null	Serving-resolved display label: the stored title/name, else a bounded caption excerpt; null when the node has no readable label or its name must not be exposed (a contact's email or WhatsApp).
`publicUrl`可选string \| null	Public HTTPS link built from the hit's own stored identity (a source post/creator/product page); null when no link can be built without guessing or when the node has no public page. Never a media or signed CDN URL.

NodeKind可选值 · 11

Every node kind one DP search can start from or ask for.

可选值: PRODUCTSTORECREATORCONTENTKEYWORDCONTACTPLATFORM_DEFINED_CATEGORYBRANDPRODUCT_FAMILYMOTIFCONCEPT

NodeRef3

One kind- and channel-scoped reference used in DP, never a bare ID list.

`kind`必填NodeKind	Node kind that defines the key namespace.
`channel`可选Channel \| null	Source channel the referenced record lives in; null for a derived node's own scope.
`key`必填string	Kind- and scope-qualified key of the referenced node.

NotificationCreate4

Immutable generic producer-filed note that people read per source event.

`kind`可选string	可选值: `NOTIFICATION` 默认: `"NOTIFICATION"`
`content`必填ItemContent
`key`必填string
`ref`必填string

NotificationItem9

A stored note with no shared status; who read it lives in per-person receipts.

`id`必填string
`owner`必填OwnerRef
`current`必填ItemContent
`created_at`必填string
`revision`必填integer
`created_by`可选ActorRef \| null
`kind`可选string	可选值: `NOTIFICATION` 默认: `"NOTIFICATION"`
`object`可选string	可选值: `notification_item` 默认: `"notification_item"`
`creation`必填NotificationCreate

ObjectKind可选值 · 7

Name the seven source entity kinds returned by Data Infra.

可选值: PRODUCTSTORECREATORCONTENTKEYWORDCONTACTPLATFORM_DEFINED_CATEGORY

ObjectOutline20

One object as the agent reads it; focus objects carry their resolved layers and overrides.

`objectId`必填string
`kind`必填BoardObjectKind
`name`必填string
`position`必填BoardPoint
`state`必填ObjectState
`changedAtRevision`必填integer
`source`可选ContentSource \| null
`parentId`可选string \| null
`recipe`可选VariantRecipe \| null
`preset`可选string \| null
`size`可选PixelSize \| null
`background`可选Color \| null
`layers`可选ImageLayer[] \| TextLayer[] \| ShapeLayer[] \| GroupLayer[] \| null
`overrides`可选LayerOverride[] \| null
`staleParts`可选StalePart[]	默认: `[]`
`unresolved`可选UnresolvedBrandRef[]	默认: `[]`
`findings`可选SlotFinding[]	默认: `[]`
`columns`可选PlanColumn[] \| null
`rows`可选PlanRow[] \| null
`kitId`可选string \| null

ObjectState可选值 · 7

The one badge an object shows; derived, never stored. Precedence top to bottom.

可选值: GENERATINGQUEUEDBROKENFAILEDSTALELOCKEDREADY

ObjectStatus4

One non-READY object's badge, lock and the steps behind it (SetStatus.objects).

`objectId`必填string
`state`必填ObjectState
`locked`必填boolean
`stepIds`可选string[]	默认: `[]`

ObservationOrigin可选值 · 2

Label who measured one metric value.

可选值: SOURCE_REPORTEDCAPTURED

OpacityField2

Override value: a layer's opacity.

`field`可选string	可选值: `OPACITY` 默认: `"OPACITY"`
`opacity`必填number

OperationQuote2

How many paid steps of one operation a batch would admit.

`operation`必填ImageOperation
`steps`必填integer

OptionRecord5

One option of a dimension; banded options keep their bounds.

`key`必填string
`label`必填LocalizedText
`low`可选number \| string \| null
`high`可选number \| string \| null
`catchAll`可选boolean	默认: `false`

OrderDesigns3

Move one object in the board order (z-order and LAYERS tree): directly above above, or to the bottom.

`action`可选string	可选值: `ORDER_DESIGNS` 默认: `"ORDER_DESIGNS"`
`objectId`必填string
`above`必填string \| null

OrderLayer4

Move one layer in the stack: directly above above, or to the bottom when None.

`action`可选string	可选值: `ORDER_LAYER` 默认: `"ORDER_LAYER"`
`designId`必填string
`layerId`必填string
`above`必填string \| null

OwnedPhotoRef1

The consumer-held reference to one photo the owner uploaded through add_photos.

asset必填AssetRef

OwnerKind可选值 · 2

The two supported item-list owners.

可选值: USERORG

OwnerRef2

One user or organization list selected by the authenticated host.

`kind`必填OwnerKind
`id`必填string

OwnerType可选值 · 3

可选值: USERORGROOT

PageProgress2

How far one page got against what the caller asked for.

`requested`必填integer	Rows the caller asked for.
`hops`可选HopProgress[]	One entry per executed step, in plan order. 默认: `[]`

PageRequest2

How one bounded read pages: a row limit and the opaque cursor that continues it.

`limit`可选integer	Maximum rows in this page. 默认: `200`
`cursor`可选string \| null	Opaque cursor from the previous page.

PaidStepState可选值 · 9

Lifecycle of one paid step (one attempt): admitted in the request, run by the worker, landed alone.

可选值: RESERVEDQUEUEDRUNNINGSUCCEEDEDAPPLIEDSKIPPEDFAILEDUNKNOWNCANCELLED

PaidStepView9

One paid step as the agent and the editor see it.

`attemptId`必填string
`action`必填CutOutProduct \| GenerateScene \| GenerateDecor
`state`必填PaidStepState
`refusal`可选EditRefusalCode \| null
`chargeRefusal`可选ChargeRefusalCode \| null
`failure`可选ProviderFailureCode \| null
`revision`可选integer \| null
`queuedAt`可选string \| null
`waitingForUnlock`可选boolean	默认: `false`

ParagraphBlock2

One paragraph of plain text with inline **strong**, *em* and [label](https://...).

`kind`可选string	可选值: `PARAGRAPH` 默认: `"PARAGRAPH"`
`text`必填string

PathGeometry2

A library outline filling the box, stretched/rotated by it; no free-form path data.

`kind`可选string	可选值: `PATH` 默认: `"PATH"`
`path`必填PathKey

PathKey可选值 · 20

One immutable curated outline from the keble-core 1000-unit square path library.

可选值: SEAL_SCALLOPRIBBON_BANNERSPEECH_BUBBLEPRICE_TAGTORN_BANDBRUSH_BANDBRUSH_SWIRLBRUSH_STROKEBRUSH_UNDERLINESPLASHBLOB_SOFTBLOB_WAVEWAVE_EDGEFLAMELEAFDROPHEARTCHECKARROWSPARKLE

PeerIntent可选值 · 2

What a same-kind search means when it asks for peers.

可选值: COMPETITORSLOOKALIKES

Permission4

One provider-side permission a read or write needs, as the plugin declares it.

`key`必填string	The declared permission key.
`title`必填string	Short label of the permission.
`grantedBy`必填GrantedBy	Who can grant it, which decides who must act.
`grantHint`必填StoreLocalizedText	What the grantor must change and where, in both languages.

Phase可选值 · 4

The four user-visible phases (the existing stepper), subject-neutral.

可选值: SCOPEITEMSDIMENSIONSANALYSIS

PhaseStatus可选值 · 4

WAITING_FOR_USER is distinct from WORKING: busy is not idle (existing ruling).

可选值: WORKINGWAITING_FOR_USERCOMPLETEFAILED

PhotoLinkProblem3

Why one owner photo link produced no photo; the same shape for every code.

`url`必填string
`code`必填GuardedFetchRefusalCode \| PhotoLinkTransportCode
`detail`必填string

PhotoLinkTransportCode可选值 · 1

A link's transport fault that is not a policy refusal (owned here; keble-helpers stays raise-only).

可选值: UNREACHABLE

PhotoLinksAdded2

The one owner-scoped intake result plus one typed problem per link that produced no photo.

`intake`必填PhotosAdded \| IntakeRefusal
`problems`可选PhotoLinkProblem[]	默认: `[]`

PhotoLinksRequest2

HTTPS images stored as owner photos or scene-only references in one bounded intake.

`urls`必填string[]
`origin`可选string	可选值: `UPLOADREFERENCE` 默认: `"UPLOAD"`

PhotosAdded4

The accepted uploads, in upload order, and their hints.

`photos`必填OwnedPhotoRef[]
`references`可选AssetRef[]	默认: `[]`
`findings`可选IntakeFinding[]	默认: `[]`
`defaultStarterPaidSteps`必填integer

PixelSize2

A raster size in pixels.

`width`必填integer
`height`必填integer

PlaceBrandKit5

Add a card showing one owner kit (UNKNOWN_BRAND_KIT for an unknown or foreign kit).

`action`可选string	可选值: `PLACE_BRAND_KIT` 默认: `"PLACE_BRAND_KIT"`
`objectId`必填string
`name`必填string
`kitId`必填string
`position`可选BoardPoint \| null

PlaceholderBinding2

A plan column whose cell text replaces every source text layer carrying this placeholder.

`binding`可选string	可选值: `PLACEHOLDER` 默认: `"PLACEHOLDER"`
`placeholder`必填string	可选值: `bodycallout_1callout_2callout_3headlineproduct_photo`

PlanColumn3

One plan column; binding=None is a note column the agent reads (angle, audience).

`columnId`必填string
`title`必填string
`binding`可选TextLayerBinding \| PlaceholderBinding \| SceneCueBinding \| null

PlanRow3

One plan row: cells maps a column id to its text; name names the generated image.

`rowId`必填string
`cells`可选object
`name`可选string \| null

PlanRowRef2

One row of one plan; held by the variant that row produced (the only row -> image link).

`planId`必填string
`rowId`必填string

PlannedPost6

One row of the post plan (1.2): topic, abstract, tone, length and intended images.

`postKey`必填string
`topic`必填string
`abstract`必填string
`toneKey`必填string
`targetWords`必填integer
`imagePlan`必填string

PlatformDefinedCategory10

Represent one catalog category node that a platform itself defines.

`kind`可选string	可选值: `PLATFORM_DEFINED_CATEGORY` 默认: `"PLATFORM_DEFINED_CATEGORY"`
`channel`必填Channel
`externalId`必填string
`name`必填string
`parentRef`可选SourceSubject \| null
`path`可选string[]	默认: `[]`
`market`可选string \| null
`metrics`可选MetricObservation[]	默认: `[]`
`observedAt`必填string
`provenance`必填Provenance

PluginDeclaration5

Everything one plugin package declares: sources, metrics and write-family switches.

`key`必填string	Catalog plugin identifier.
`title`必填string	Display name of this plugin.
`sources`必填Source[]	Sources this plugin can connect.
`metrics`可选Metric[]	Metrics this plugin calculates; empty for live-read-only plugins. 默认: `[]`
`actionFamilies`可选ActionFamily[]	Unique owner-facing families used by this plugin's actions. 默认: `[]`

PolicyCitation4

The captured official source passage behind one rule.

`policyUrl`必填string
`section`必填string
`capturedOn`必填string
`snapshotSha256`必填string

PolygonGeometry3

A polygon (inner_ratio=1) or star inscribed in the box, first corner up.

`kind`可选string	可选值: `POLYGON` 默认: `"POLYGON"`
`corners`必填integer
`innerRatio`可选number	默认: `1`

PositioningCellQuery3

Ask for one cell's detail dialog, the reading client's cell read.

`object`可选string	可选值: `positioning_cell` 默认: `"positioning_cell"`
`cellKey`必填string
`viewId`可选string \| null

PositioningDetail3

One answered detail query: the reading client's answer plus the labels it uses.

`object`可选string	可选值: `positioning_detail` 默认: `"positioning_detail"`
`answer`必填CellDetail \| PositioningItemPage
`labels`必填PositioningDetailLabels

PositioningDetailLabels7

The labels one detail answer needs to be read by a person, and nothing more.

`object`可选string	可选值: `positioning_detail_labels` 默认: `"positioning_detail_labels"`
`itemNoun`必填LocalizedText
`dimensions`可选DimensionRecord[]	默认: `[]`
`measures`可选RoomPublicMeasure[]	默认: `[]`
`assessments`可选RoomPublicAssessment[]	默认: `[]`
`facts`可选FactSpec[]	默认: `[]`
`criterion`可选LocalizedText \| null

PositioningItemsQuery3

Ask for one page of items, the reading client's items read.

`object`可选string	可选值: `positioning_items` 默认: `"positioning_items"`
`cellKey`可选string \| null
`cursor`可选string \| null

PositioningRecord12

One positioning: its one plugin, its setup, its review setting, and its stepper.

`ref`必填PositioningRef
`positioningId`必填string
`gridId`可选string \| null
`pluginId`必填string
`language`可选Language	The language every model-written, user-visible positioning text must use. 默认: `"ENGLISH"`
`brief`必填string
`ownerNote`可选string	默认: `""`
`setup`可选object \| null
`review`可选object
`phase`必填Phase
`status`必填PhaseStatus
`createdAt`必填string

PositioningRef2

One positioning, addressed by its owner and the host task that holds it.

`owner`必填OwnerScope
`taskId`必填string

PostDraft3

POST_DRAFTS (1.4): one planned post written in its tone with text and images mixed.

`step`可选string	可选值: `POST_DRAFTS` 默认: `"POST_DRAFTS"`
`postKey`必填string
`post`必填ComposedPost

PostEntry3

One planned post and its latest content; post is empty until its draft lands.

`plan`必填PlannedPost
`post`可选ComposedPost \| null
`reviewNotes`可选string \| null

PostPlan3

POST_PLAN (1.2): the tones, then how many posts in which order; the count bound is a Setting.

`step`可选string	可选值: `POST_PLAN` 默认: `"POST_PLAN"`
`tones`必填ToneSpec[]
`posts`必填PlannedPost[]

PostSelfReview4

SELF_REVIEW (1.5): the agent's own pass for a natural, human tone, and the revised post.

`step`可选string	可选值: `SELF_REVIEW` 默认: `"SELF_REVIEW"`
`postKey`必填string
`reviewNotes`必填string
`post`必填ComposedPost

PostSet8

The whole guided state: direction, plan with tones and posts, style examples, the parked step.

`status`必填PostSetStatus
`parkedStep`必填BlogStep \| null
`direction`可选BlogDirection \| null
`tones`可选ToneSpec[]	默认: `[]`
`posts`可选PostEntry[]	默认: `[]`
`styleExamples`可选StyleExample[]	默认: `[]`
`sample`可选SampleConfirmation \| null
`reviewRound`可选integer	默认: `0`

PostSetStatus可选值 · 2

Where the post set stands.

可选值: WAITING_FOR_AGENTREADY

PreviewSession4

The run's one preview copy: which theme, copied from which target, and which revision it holds.

`copyThemeId`必填string
`createdFromThemeId`必填string
`documentRevisionOnCopy`可选integer \| null
`createdAt`必填string

PreviewView3

Stateless answer to a preview request, with outcomes and diffs aligned to its batch.

`batch`必填ActionBatch	Requested action batch; nothing is persisted by preview.
`previews`必填ActionOutcome[]	One live outcome per action, in order.
`diffs`必填ActionDiff[]	One derived diff per action, in order.

PriceClause5

Apply a typed monetary bound without binary-float price values.

`kind`可选string	可选值: `PRICE` 默认: `"PRICE"`
`op`必填string	可选值: `GTELTE`
`value`必填MinorUnitMoney
`metric`可选string	可选值: `pricelist_price` 默认: `"price"`
`averageDays`可选integer \| null

Priority可选值 · 2

The initial human-attention levels.

可选值: NORMALCRITICAL

PrivateValue3

One private leaf held outside its row; never returned by any read.

`rowKey`必填string
`pointer`必填string
`value`必填JsonValue

Product27

Represent one provider-neutral sellable item.

`kind`可选string	可选值: `PRODUCT` 默认: `"PRODUCT"`
`channel`必填Channel
`externalId`必填string
`title`可选string \| null
`description`可选string \| null
`brand`可选string \| null
`manufacturer`可选string \| null
`modelNumber`可选string \| null
`category`可选string \| null
`categoryPath`可选string[]	默认: `[]`
`tags`可选string[]	默认: `[]`
`market`可选string \| null
`url`可选string \| null
`features`可选string[]	默认: `[]`
`attributes`可选ProductOption[]	默认: `[]`
`publishedAt`可选string \| null
`releasedAt`可选string \| null
`firstTrackedAt`可选string \| null
`storeRef`可选SourceSubject \| null
`storeName`可选string \| null
`identities`可选ExternalIdentity[]	默认: `[]`
`variants`可选ProductVariant[]	默认: `[]`
`metrics`可选MetricObservation[]	默认: `[]`
`media`可选MediaRef[]	默认: `[]`
`status`可选ListingStatus	默认: `"ACTIVE"`
`observedAt`必填string
`provenance`必填Provenance

ProductBrief2

What the owner gave us: product photos (may be empty on a board, demo 3) and a plain description.

`photos`可选AssetRef[]	默认: `[]`
`description`必填string

ProductContent9

The editable unpublished product draft; the whole value becomes one product.create.

`title`必填string
`handleStem`必填string
`descriptionHtml`可选string \| null
`vendor`可选string \| null
`productType`可选string \| null
`tags`可选string[]	默认: `[]`
`options`可选ShopifyProductOption[]	默认: `[]`
`variants`必填ProductVariantFields[]
`images`可选ExistingShopifyFile[] \| ShopifyRemoteImage[] \| PostExportedImage[]	默认: `[]`

ProductCreateRequest3

Create one draft pinned to exactly one ELTA store; it carries only store_id.

`replayKey`必填string
`storeId`必填string
`content`必填ProductContent

ProductFamily4

A DP-derived product family with its count; members are resolved through the `VARIANT_OF` relation, never through an unscoped array.

`kind`可选string	Node discriminator; always PRODUCT_FAMILY. 可选值: `PRODUCT_FAMILY` 默认: `"PRODUCT_FAMILY"`
`key`必填string	The product family's own analyzed key.
`title`必填string \| null	Display title of the family; null when the source states none.
`memberCount`必填integer	Number of products in this family.

ProductFillRule2

The product's visible pixels span at least min_ratio of the frame's longer side (Amazon ~85%).

`kind`可选string	可选值: `PRODUCT_FILL` 默认: `"PRODUCT_FILL"`
`minRatio`必填number

ProductImagesDetailView可选值 · 1

What may be read in detail about one image set.

可选值: EXPORTS

ProductOptionValue2

One option name/value pair that places a variant in the product's options.

`optionName`必填string
`value`必填string

ProductProposalFiling3

The ids of one FiledApproval this artifect keeps, and which ELTA action type it filed.

`proposalId`必填string
`inboxItemId`必填string
`actionTypeKey`必填string

ProductReleasedType可选值 · 4

可选值: UNIDENTIFIABLEOLD_RELEASEDNEW_RELEASEDNEW_RELEASED_ON_OLD_ASIN

ProductSimilarType可选值 · 4

可选值: SAME_MODELSAME_PRODUCT_SUBCATEGORYSAME_PRODUCT_CATEGORY_BUT_DIFFERENT_SUBCATEGORYDIFFERENT_PRODUCT_CATEGORY

ProductSnapshot9

The owner-visible draft at one revision, with its screen result and every filed proposal.

`artifectRef`必填ArtifectRef
`storeId`必填string
`account`必填AccountRef
`revision`必填integer
`content`必填ProductContent
`screening`必填ScreeningResult
`proposals`可选ProductProposalFiling[]	默认: `[]`
`filingIntent`可选StagedProposal \| null
`approvals`可选ApprovalState[]	默认: `[]`

ProductTypeSchema2

A resolved seller-specific definition with the pin that identifies its bytes.

`reference`必填ProductTypeSchemaRef
`schemaDocument`必填object

ProductTypeSchemaRef3

Pin one target to the exact seller-specific Product Type Definition version and bytes.

`target`必填ListingTarget
`version`必填string
`schemaSha256`必填string

ProductVariant6

Retain the observed SKU, model number, and options of one Product variant.

`sku`可选string \| null
`modelNumber`可选string \| null
`options`可选ProductOption[]	默认: `[]`
`ref`可选SourceSubject \| null
`price`可选MinorUnitMoney \| null
`available`可选boolean \| null

ProductVariantFields4

One variant sent in the same productSet call: option values, price, SKU and barcode.

`optionValues`可选ProductOptionValue[]	默认: `[]`
`price`必填number \| string
`sku`可选string \| null
`barcode`可选string \| null

ProfileInputsAdjustment11

Patch the seller's setup after finishing, then re-price the cohort.

`suggestedPurchasingCost`可选SuggestedPurchasingCost \| null	The seller's own purchasing cost for one benchmark ASIN; never a Keble estimate.
`acosLowerbound`可选integer \| null	ACOS lower bound, whole percent.
`acosUpperbound`可选integer \| null	ACOS upper bound, whole percent.
`fixedLength`可选number \| null	Fixed length.
`fixedWidth`可选number \| null	Fixed width.
`fixedHeight`可选number \| null	Fixed height.
`fixedLengthUnit`可选string \| null	Unit of the fixed size; None means cm.
`fixedWeight`可选number \| null	Fixed weight.
`fixedWeightUnit`可选string \| null	Unit of the fixed weight; None means g.
`investmentDifficultyAmountThreshold`可选MinorUnitMoney \| null	Entry-budget threshold.
`adjustmentType`可选string	可选值: `PROFILE_INPUTS` 默认: `"PROFILE_INPUTS"`

ProfitBreakdown9

One coherent scenario's exact selling-price-to-profit waterfall.

`scenarioKey`必填string
`role`必填ScenarioRole
`shippingMode`必填ShippingMode
`isPeakPeriod`必填boolean
`sellingPrice`必填MinorUnitMoney
`lines`必填ProfitBreakdownLine[]
`profit`必填MinorUnitMoney
`margin`必填number
`sizing`必填SizingDetail

ProfitBreakdownLine7

One settled deduction between selling price and unit profit.

`kind`必填ProfitLineKind
`amount`必填MinorUnitMoney
`shareOfPrice`必填number
`source`必填EstimateSource
`ratio`可选number \| null
`storageDetail`可选StorageLineDetail \| null
`firstLegDetail`可选FirstLegLineDetail \| null

ProfitEnvelope8

Margin range produced by evaluating every coherent scenario.

`expected`必填ProfitBreakdown
`optimistic`必填ProfitBreakdown
`pessimistic`必填ProfitBreakdown
`tierProbes`必填ProfitBreakdown[]
`marginLower`必填number
`marginUpper`必填number
`marginBoundScenarioKeys`必填any[]
`profitBoundScenarioKeys`必填any[]

ProfitInputOverride4

Named ASINs whose physical or purchasing inputs are replaced.

`asins`必填string[]	ASINs this override applies to.
`dimensions`可选ReportMaterialDimensionsAnswer \| null	Replacement three-axis dimensions.
`weight`可选ReportMaterialWeightAnswer \| null	Replacement weight.
`unitCost`可选ReportMaterialCostAnswer \| null	Replacement purchasing unit cost bounds.

ProfitInputsAdjustment2

Replace profit-calculator inputs, then recompute the whole report.

`adjustmentType`可选string	可选值: `PROFIT_INPUTS` 默认: `"PROFIT_INPUTS"`
`overrides`必填ProfitInputOverride[]	One override group per target ASIN set.

ProfitLineKind可选值 · 8

One deductible economic line between selling price and unit profit.

可选值: PURCHASING_COSTFIRST_LEG_SHIPPINGFBA_FULFILLMENTSTORAGEREFERRALVATADSRETURNS

ProgressTaskStage可选值 · 3

可选值: PENDINGSUCCESSFAILURE

ProgressiveReportSnapshot18

Everything a reader needs about a V3 report at one committed revision.

`created`可选string
`updated`可选string
`formatVersion`可选string	Frozen V3 read-model format identity. 可选值: `3.0.0` 默认: `"3.0.0"`
`rootTaskId`必填string	Owning keble-task identity.
`reportRevision`必填integer	Revision this snapshot reads.
`amazonMarketplace`必填AmazonMarketplace	PRODUCT market this report actually analysed.
`completeness`必填ReportCompleteness	Completeness right now.
`taskStage`必填ProgressTaskStage	Owning task stage.
`readyUnits`可选ReportUnitDescriptor[]	Phases with an accepted artifact. 默认: `[]`
`missingUnits`可选ReportGapDescriptor[]	Phases with an explicit typed gap. 默认: `[]`
`conclusion`可选ReportConclusion \| null	Business verdict, when one was reached.
`terminalState`可选ReportTerminalState \| null	Operational stop state, when the run stopped.
`listings`可选ReportListingPage \| null	First cursor page of listing summaries.
`listingSummaries`可选ReportListingSummaryView[] \| null	Optional UNSLICED listing summaries for the whole committed LISTING_BUILD cohort; None on the Keble-line read.
`estimationMethodology`可选ReportEstimationMethodologyView \| null	How every material verdict was reached.
`openMaterialQuestions`可选ReportMaterialQuestion[]	Typed material questions awaiting an owner answer. 默认: `[]`
`updatedAt`必填string	Instant the read revision was committed.
`seoIndexable`可选boolean	Backend-owned crawlability decision. 默认: `false`

ProposalAttribution3

Why a proposal exists and which origin asked for it; display data that grants no authority.

`originKind`必填string	Opaque origin label, such as an Artifect kind.
`originRef`必填string	Origin reference, such as an Artifect id.
`reason`可选string \| null	Short display reason, if any.

ProposalDecline3

Who declined an open proposal, when, and their optional display reason.

`actor`必填StoreActorRef	Verified actor that declined the proposal.
`declinedAt`必填string	Instant the proposal was declined.
`reason`可选string \| null	Display reason for declining.

ProposalFiling2

The two ids of one FiledApproval an artifect keeps: what to view and what to revert.

`proposalId`必填string
`inboxItemId`必填string

ProposalRef2

Reference to the exact immutable proposal preview shown to a human.

`source`必填string
`id`必填string

ProposalState可选值 · 5

Where a proposal stands in its one-time approval and apply lifecycle.

可选值: PROPOSEDAPPLYINGAPPLIEDEXPIREDDECLINED

ProposalTarget可选值 · 2

What a model proposal is asked for.

可选值: SCOPEDIMENSIONS

ProposalView4

The response shared by every proposal route: stored proposal plus derived action diffs.

`proposal`必填ActionProposal	Stored proposal, preview or applied result.
`diffs`必填ActionDiff[]	One derived diff per action, in batch order.
`applyScopes`可选string[] \| null	Each scope:level that approving (applying) this proposal needs, from the same access check approval runs; null when not stated.
`declineScopes`可选string[] \| null	Each scope:level that declining this proposal needs, from the same access check decline runs; null when not stated.

Propose4

Ask the model for a new proposal, steered by a note (today's REFINE answer, and add-dimension).

`type`可选string	可选值: `PROPOSE` 默认: `"PROPOSE"`
`actionKey`必填string
`target`必填ProposalTarget
`note`可选string	默认: `""`

Provenance7

Record non-provider-identifying capture facts attached to an entity.

`capturedAt`必填string
`sourceChangedAt`可选string \| null
`sourceRequestId`可选string \| null
`artifactIds`可选string[]	默认: `[]`
`estimated`可选boolean	默认: `false`
`confidence`可选number \| null
`readFields`可选string[] \| null

ProviderAction6

One requested provider change; its live before-value is read at apply time, not previewed.

`actionKey`必填string	Caller-owned key aligning outcomes with this action.
`actionTypeKey`必填string	The declared action type to perform.
`account`必填AccountRef	Provider account the change targets.
`target`必填EntityRef
`change`必填JsonValue	The requested change payload.
`baseVersion`可选string \| null	Live token the caller based this draft on.

ProviderFailureCode可选值 · 7

The finite, sanitized provider failure vocabulary (consumers never parse provider text).

可选值: INVALID_INPUTINVALID_OUTPUTCONTENT_REFUSEDRATE_LIMITEDUNAVAILABLEOUTCOME_UNKNOWNNOT_CONFIGURED

ProviderIssue8

A provider refusal or failure, carried as data instead of raised as an error.

`object`可选string	Fixed tag marking this object as a provider issue. 可选值: `provider_issue` 默认: `"provider_issue"`
`kind`必填IssueKind	Why the provider refused or failed the call.
`permission`可选Permission \| null	The missing permission; only for a permission-missing issue.
`credential`可选Credential \| null	The updatable value to renew; only for an auth-invalid issue that names one.
`retryAfter`可选string \| null	When to retry a wait-style issue; none uses the default back-off.
`providerCode`可选string \| null	The provider's own code, kept for support.
`providerMessage`可选string	The provider's text, kept for support; never a secret. 默认: `""`
`resolution`可选Resolution	Who must resolve it; derived from kind and permission.

ProviderRegion可选值 · 3

Sales region chosen before consent.

可选值: NAEUFE

QueryPage5

One bounded aggregation result page, reusing the shared cursor/total contract.

`rows`必填QueryRow[]	Rows in this page.
`nextCursor`可选string \| null	Continuation cursor; null on the last page.
`totalRows`必填integer	Rows matching the whole read, across all pages.
`emptyReason`可选string \| null	Why this page is empty and what selection or source to check.
`object`可选string	Document type: aggregation query page. 可选值: `query_page` 默认: `"query_page"`

QueryRequest5

Select a logical target and optionally narrow the authenticated owner's stores/accounts.

`target`必填QueryTarget	Catalog fact family to read, or METRIC_DAYS for calculated daily values.
`storeIds`可选string[]	Stores to include; empty selects the asserted owner's stores. 默认: `[]`
`accountIds`可选string[]	Accounts to include within those stores; empty selects all their accounts. 默认: `[]`
`pipeline`必填QueryStage[]	Read-only aggregation stages over the selected logical rows.
`page`可选PageRequest	Page size and continuation cursor for this exact read. 默认: `{"limit":200}`

QueryRow0

没有字段。

QueryStage0

没有字段。

QueryTarget以下之一 · 2

以下之一: string | string

QuoteBlock2

One pull quote or customer quote the merchant supplied.

`kind`可选string	可选值: `QUOTE` 默认: `"QUOTE"`
`text`必填string

RadialGradient2

A fill from the box centre to its farthest corner for a vignette or spotlight.

`stops`必填GradientStop[]
`gradient`可选string	可选值: `RADIAL` 默认: `"RADIAL"`

RangeValue5

One range an assessment produced for a cell, with its own evidence and references.

`label`必填string
`low`必填number \| string
`high`必填number \| string
`evidence`可选string	默认: `""`
`references`可选SourceReference[]	默认: `[]`

RankingWindow2

Identify one calendar ranking-board edition without a trend date span.

`windowType`必填RankingWindowType
`windowValue`必填string

RankingWindowType可选值 · 3

Name calendar editions for provider ranking boards, not metric periods.

可选值: DAYWEEKMONTH

RatioCombine3

Range value = sum(numerator) / sum(denominator) over the same days and entity.

`kind`可选string	Range combination: ratio of summed operands. 可选值: `ratio` 默认: `"ratio"`
`numerator`必填string	Metric summed for the ratio's numerator.
`denominator`必填string	Metric summed for the ratio's denominator.

RecordAddress3

The ONE public record address: one analyzed record's kind and key.

`kind`必填AnalyzedRecordKind
`recordKey`必填string
`seriesWindow`可选DateWindow \| null	Inclusive date window for an opt-in record-level metric series; null requests no series.

RecordDetail17

A public detail object for one analyzed record.

`object`必填string	Public object discriminator. 可选值: `record_detail`
`recordKind`必填AnalyzedRecordKind	Record family.
`recordKey`必填string	Stable record key.
`channel`必填Channel \| null	Source channel, when applicable.
`freshness`可选RecordFreshnessTimes
`observedAt`可选string \| null	When the pinned revision's facts were observed (capture instant); null when unknown. Distinct from freshness.last_checked_at.
`externalId`可选string \| null	Channel-native id of the source subject (the ASIN of an Amazon product), when stored.
`market`可选string \| null	ISO 3166-1 alpha-2 market of the source subject, when stored.
`label`可选string \| null	Readable display label, when known.
`relations`可选RelationRef[]	Observed relations to other served nodes. 默认: `[]`
`unlinkedMentions`可选UnlinkedMention[]	Claims of the record that name an entity no held record matched; at most 16. 默认: `[]`
`fields`必填object	Authorized record scalar fields.
`absentFields`可选string[] \| null	Recipe fields with DIC FieldState.ABSENT: read but empty, unlike fields not read; omitted when unknown.
`fieldValues`可选object \| null	Effective values per field code with their basis and inference; omitted when not read.
`concepts`必填ConceptRef[]	Concepts attached to the record.
`metrics`可选MetricObservation[]	Latest typed observation heads for this record; at most 128. 默认: `[]`
`series`可选MetricObservation[]	Opt-in dated observations for the requested window; at most 32 points. 默认: `[]`

RecordFieldValue3

ONE stored field value together with where that value came from.

`value`必填string \| integer \| number \| string \| boolean	The stored scalar value; money stays an exact major-unit Decimal.
`basis`必填ValueBasis	Where the value came from: OBSERVED or INFERRED.
`inferred`可选InferredFact \| null	Provenance of an inferred value; explicitly null when the source stated it.

RecordFreshnessTimes3

Stored, pinned freshness facts of one current material revision.

`sourceChangedAt`可选string \| null
`lastCheckedAt`可选string \| null
`lastNewValueAt`可选string \| null

RectGeometry2

A rectangle filling the box; corner_radius in pixels (badges, panels).

`kind`可选string	可选值: `RECT` 默认: `"RECT"`
`cornerRadius`可选number	默认: `0`

RedeemCodeRefusalReason可选值 · 10

Finite refusal facts for code updates, redemption and trial application.

可选值: INVALID_CODELEGACY_TOKENDISABLEDUPDATE_LOCKEDMAX_CONSUMEACTOR_LIMITIDENTITY_CONFLICTRELEASEDGRANT_CHANGEDTRIAL_NOT_ELIGIBLE

ReferencesDetailValue4

A REFERENCES detail row: the cell's deduplicated source references.

`object`可选string	可选值: `references_detail_value` 默认: `"references_detail_value"`
`kind`可选string	可选值: `REFERENCES` 默认: `"REFERENCES"`
`key`必填string
`references`可选SourceReference[]	默认: `[]`

ReferencesRow1

Every source reference of the cell's assessments and items, deduplicated.

kind可选string

可选值: REFERENCES

默认: "REFERENCES"

Refusal3

One typed refusal: the code, the request field it concerns, and one DP-worded sentence.

`code`必填RefusalCode	Stable refusal code.
`field`可选string \| string \| null	Request field the refusal concerns; null when it concerns the whole request.
`detail`必填string	Safe explanation of the refusal.

RefusalCode可选值 · 24

THE ONE refusal vocabulary: every way DP declines to serve a request or a plan as asked, in a code an agent can act on.

可选值: EDGE_MISSINGEDGE_DISABLEDGROW_KIND_MISMATCHANALYZED_BELOW_LIVEDERIVED_KIND_NEEDS_ANALYZEDWINDOW_CATEGORY_REQUIREDMOTIF_PRESET_INVALIDEXCLUDE_KIND_MISMATCHTEXT_FROM_UNSUPPORTEDPUBLISHED_TARGET_IDS_SETBOUND_OUT_OF_RANGEPLAN_TOO_LARGEUNBUILDABLE_QUERYPUBLISHED_PRESET_SETWINDOW_BEFORE_POLICYCHANNEL_REQUIREDLEG_UNAVAILABLEINVALID_REFERENCESOURCE_REJECTED_REQUESTUNSUPPORTED_QUESTIONVALIDATION_EXHAUSTEDDATA_CHANGEDINVALID_CURSORNOT_AVAILABLE

RelationClause7

A HOP along a relation — it binds a `RelationBinding`, and its index is what a `FeatureClause` with `on=TARGET` points at.

`kind`必填string	可选值: `RELATION`
`relation`必填AnalyzedRelationKind
`direction`必填string	可选值: `OUTIN`
`targetKind`必填NodeKind \| ConceptKind
`targetRefs`可选NodeRef[]	默认: `[]`
`targetWindow`可选ResolvedWindow \| null
`targetChannel`可选Channel \| null

RelationHop3

ONE typed step of a relation path, so an answer can say HOW two records were connected instead of asserting that they are.

`relation`必填AnalyzedRelationKind	The relation this hop traverses.
`fromKey`必填string	Analyzed key of the hop's subject node.
`toKey`必填string	Analyzed key of the hop's object node.

RelationRef13

One typed relation shared by analyzed details and public node results.

`stance`可选ClaimStance \| null	What the source item does toward the named entity in the cited claim; null when no claim is cited, the claim predates mention capture, or (on a relation) the edge's basis is SIMILAR (its claim names no such record).
`mainSubject`可选boolean \| null	Whether the cited claim names what the source item mainly promotes or is about; null when stance is null.
`emotion`可选ClaimEmotion \| null	How the source item feels about the named entity in the cited claim, STRONGLY_NEGATIVE to STRONGLY_POSITIVE; null when stance is null.
`phrase`可选string \| null	The source item's own words showing how it brings the named entity up, from the cited claim; null when not found verbatim, visual only, captured before mention capture, (on a relation) the basis is SIMILAR, or no claim is cited.
`relation`必填AnalyzedRelationKind	Canonical relation joining the record to its other end.
`direction`必填string	Direction of the relation relative to the record: OUT or IN. 可选值: `OUTIN`
`other`必填NodeRef	Scoped reference to the node at the relation's other end.
`otherLabel`可选string \| null	Readable label of the related node, when known.
`otherRecordKey`可选string \| null	Analyzed record key of the related node when served.
`evidence`必填string	Stored citation that supports the relation.
`basis`必填EvidenceBasis	Evidence basis of this relation: RECORDED, MENTIONED or SIMILAR.
`placements`可选SearchPlacement[]	Display placements carried by a RANKED_FOR relation; empty otherwise. 默认: `[]`
`metrics`可选MetricObservation[]	Metric observations carried by any relation kind. 默认: `[]`

RelativeTargetBidChange2

A percentage change of the row's observed keyword, target or default bid.

`kind`可选string	可选值: `target_bid_adjustment` 默认: `"target_bid_adjustment"`
`percentChange`必填number \| string

RemoveBlock3

Remove one block from a section.

`action`可选string	可选值: `REMOVE_BLOCK` 默认: `"REMOVE_BLOCK"`
`sectionKey`必填string
`blockKey`必填string

RemoveDesign2

Remove any board object; HAS_VARIANTS while a variant or plan still names it.

`action`可选string	可选值: `REMOVE_DESIGN` 默认: `"REMOVE_DESIGN"`
`designId`必填string

RemoveItems3

Delete items; their placements go with them (a placement of a missing item reads as nothing).

`type`可选string	可选值: `REMOVE_ITEMS` 默认: `"REMOVE_ITEMS"`
`actionKey`必填string
`keys`必填string[]

RemoveLayers3

Remove layers (and a group's children with it).

`action`可选string	可选值: `REMOVE_LAYERS` 默认: `"REMOVE_LAYERS"`
`designId`必填string
`layerIds`必填string[]

RemoveScope可选值 · 2

The targets a REMOVE action is declared to be allowed to delete.

可选值: ELTA_CREATEDANY_WITH_SNAPSHOT

RemoveSection2

Remove one section from the document; publish then removes its placement.

`action`可选string	可选值: `REMOVE_SECTION` 默认: `"REMOVE_SECTION"`
`sectionKey`必填string

RenderFormat可选值 · 3

Export encodings the stores accept and we produce (WEBP: agent previews and owner downloads).

可选值: JPEGPNGWEBP

ReorderViews5

Put the viewer's saved views in a new order (every existing view id, once).

`type`可选string	可选值: `REORDER_VIEWS` 默认: `"REORDER_VIEWS"`
`actionKey`必填string
`viewer`必填ViewerRef
`expectedRevision`必填integer
`viewIds`必填string[]

ReplacePost3

Replace one post's composed content.

`edit`可选string	可选值: `REPLACE_POST` 默认: `"REPLACE_POST"`
`postKey`必填string
`post`必填ComposedPost

ReportAdjudication8

The adjudicator's structured choice between the two analyses.

`created`可选string
`updated`可选string
`candidate`必填ReportAdjudicationCandidate	The single outcome chosen from the closed candidate set.
`reasonCode`可选ReportReasonCode \| null	Closed-set reason for a concluding candidate; None for CONTINUE or CONCLUDE_SUITABLE.
`userReasoning`必填string \| null	Reader-facing justification of the choice.
`evidenceRefs`可选ReportEvidenceRef[]	Citations into accepted artifacts. 默认: `[]`
`overruledDissent`可选string	What the losing analysis argued and why it was overruled. 默认: `""`
`proseWithheld`可选boolean	True only where a public read withheld this adjudication's prose. 默认: `false`

ReportAdjudicationCandidate可选值 · 4

The closed set of outcomes an adjudicator may choose.

可选值: CONTINUECONCLUDE_SUITABLECONCLUDE_NOT_SUITABLECONCLUDE_NOT_DETERMINABLE

ReportAnalystFinding5

One structured finding from a risk or opportunity analyst.

`created`可选string
`updated`可选string
`headline`必填string	Short headline of the finding.
`reasoning`必填string	Why the cited evidence produces this finding.
`evidenceRefs`可选ReportEvidenceRef[]	Citations into accepted artifacts. 默认: `[]`

ReportAnalystRole可选值 · 3

Which independently prompted role produced a structured analysis.

可选值: RISKOPPORTUNITYADJUDICATOR

ReportClosureKind可选值 · 2

Whether the report closed before or after every required phase ran.

可选值: EARLYFINAL

ReportCohortBandCount4

How many members fall into ONE margin band.

`created`可选string
`updated`可选string
`band`必填ReportCohortMarginBand	The margin band.
`count`必填integer	Members in the band.

ReportCohortBrandAge可选值 · 3

Whether a brand entered the analysed market recently.

可选值: NEWOLDUNKNOWN

ReportCohortBrandRow9

ONE brand of the population with its lead product.

`created`可选string
`updated`可选string
`brand`必填string	Provider brand.
`brandAge`必填ReportCohortBrandAge	NEW, OLD or UNKNOWN.
`enteredAt`可选string \| null	Earliest population release of the brand.
`memberCount`必填integer
`newReleaseCount`必填integer
`profitableNewReleaseCount`必填integer
`lead`必填ReportCohortMemberRow	Member with the highest monthly units (None last, then ASIN).

ReportCohortBrandScope可选值 · 3

Which brands one brand-scope summary covers.

可选值: ALLNEW_BRANDSOLD_BRANDS

ReportCohortBrandScopeView18

New-release outcomes of the brands in ONE brand scope.

`created`可选string
`updated`可选string
`scope`必填ReportCohortBrandScope	Which brands are covered.
`brandCount`必填integer
`brandNames`可选string[]	默认: `[]`
`brandsWithNewReleaseCount`必填integer
`newReleaseCount`必填integer
`profitableNewReleaseCount`必填integer
`notProfitableNewReleaseCount`必填integer
`unresolvedNewReleaseCount`必填integer
`profitableNewReleasedCount`必填integer
`profitableNewReleasedOnOldAsinCount`必填integer
`newReleaseSuccessRate`必填ReportSuccessRate	Profitable / determinate new releases.
`newReleaseFailureRate`必填ReportSuccessRate	Not profitable / determinate new releases.
`profitableBrandNames`可选string[]	Brands with at least one profitable new release. 默认: `[]`
`notProfitableBrandNames`可选string[]	Brands with at least one not-profitable new release. 默认: `[]`
`successByBrand`可选ReportCohortBrandSlice[]	Profitable new releases: top brands, then OTHER. 默认: `[]`
`failureByBrand`可选ReportCohortBrandSlice[]	Not-profitable new releases: top brands, then OTHER. 默认: `[]`

ReportCohortBrandSlice5

One donut slice of new releases by brand.

`created`可选string
`updated`可选string
`brand`可选string \| null	Brand; None = OTHER.
`count`必填integer	New releases in the slice.
`otherBrands`可选string[]	Brands folded into the OTHER slice. 默认: `[]`

ReportCohortMarginBand可选值 · 8

One [gte, lt) band of the expected-scenario margin ratio, or OTHER.

可选值: BELOW_MINUS_10MINUS_10_TO_0ZERO_TO_10TEN_TO_20TWENTY_TO_30THIRTY_TO_40FORTY_PLUSOTHER

ReportCohortMarginDistribution5

The margin-band histogram of one member population, under two rules.

`created`可选string
`updated`可选string
`populationCount`必填integer	Members partitioned.
`byResolvedSales`必填ReportCohortBandCount[]	OTHER = no margin OR an unresolved sale; 8 bands in order.
`byKnownMargin`必填ReportCohortBandCount[]	OTHER = no margin only; 8 bands in order.

ReportCohortMemberRow22

ONE competitor as every cohort table, card and brand lead shows it.

`created`可选string
`updated`可选string
`economicListingKey`可选string \| null	Internal listing identity; owner reads only.
`publicListingHandle`可选string \| null	Opaque public listing handle; public reads only.
`asin`必填string	DISPLAY ONLY provider ASIN.
`title`可选string \| null	Provider title.
`brand`可选string \| null	Provider brand.
`imageUrl`可选string \| null	Primary image.
`ratingInt`可选integer \| null	Star rating in tenths (0-50).
`reviewCount`可选integer \| null	Provider review count.
`releasedAt`可选string \| null	Credible observed release instant.
`releasedType`可选ProductReleasedType \| null	Retained lifecycle classification.
`isProfitable`可选boolean \| null	The report's profitable flag; None unresolved.
`sellingPrice`可选MinorUnitMoney \| null	Expected-scenario selling price.
`monthlySold`可选integer \| null	Latest observed monthly units.
`monthlyRevenue`可选MinorUnitMoney \| null	Selling price x monthly units.
`expectedProfit`可选MinorUnitMoney \| null	Expected-scenario unit profit.
`monthlyProfit`可选MinorUnitMoney \| null	Expected unit profit x monthly units.
`margin`可选number \| string \| null	Expected-scenario margin ratio.
`profitableCostBasis`可选ReportPurchasingCostProvenance \| null	Purchase-cost provenance the profitable flag was priced with.
`economicsCostBasis`可选ReportPurchasingCostProvenance \| null	Purchase-cost provenance the expected scenario used.
`profitWithheld`可选boolean	True only where a public read withholds per-row profit. 默认: `false`

ReportCohortPeriodCount11

New releases released in ONE UTC calendar period, by type and outcome.

`created`可选string
`updated`可选string
`periodStart`必填string	Inclusive UTC period start.
`periodEnd`必填string	Exclusive UTC period end.
`newProfitable`必填integer
`newNotProfitable`必填integer
`newUnresolved`必填integer
`newOnOldProfitable`必填integer
`newOnOldNotProfitable`必填integer
`newOnOldUnresolved`必填integer
`marginBands`可选ReportCohortBandCount[]	Resolved-sales bands; empty before economics. 默认: `[]`

ReportCohortRankTable6

One profit ranking: the top rows plus the size of the ranked population.

`created`可选string
`updated`可选string
`key`必填ReportCohortRankTableKey	Which ranking this is.
`populationCount`必填integer	Full filtered population.
`rows`可选ReportCohortMemberRow[]	Ranked rows with a known monthly profit. 默认: `[]`
`profitWithheld`可选boolean	True only where a public read withheld this table's rows. 默认: `false`

ReportCohortRankTableKey可选值 · 4

Which profit ranking one rank table is.

可选值: PROFITABLE_ALLNOT_PROFITABLE_ALLPROFITABLE_NEWNOT_PROFITABLE_NEW

ReportCohortStandoutCase4

ONE STANDOUT pick as a case card: its listing row plus the agent's reason.

`created`可选string
`updated`可选string
`row`必填ReportCohortMemberRow	The pick's listing representative.
`reason`必填string \| null	Why this product stands out; None on owner-costed public reads.

ReportCohortSubjectDisplay8

How the report's OWN product looks on the cover: display facts only.

`created`可选string
`updated`可选string
`asin`必填string	DISPLAY ONLY subject ASIN.
`title`可选string \| null	Provider title.
`brand`可选string \| null	Provider brand.
`imageUrl`可选string \| null	Primary image.
`ratingInt`可选integer \| null	Star rating in tenths (0-50).
`reviewCount`可选integer \| null	Provider review count.

ReportCompactAbsence5

One requested section that is explicitly unavailable, with its reason.

`created`可选string
`updated`可选string
`section`必填ReportCompactSection	Section that is unavailable.
`reason`必填ReportCompactAbsenceReason	Typed reason it is absent.
`detail`必填string	Reader-facing explanation, safe to display.

ReportCompactAbsenceReason可选值 · 4

Why a requested section is not available as data.

可选值: NOT_BUILT_YETWAITING_FOR_INPUTFAILEDNOT_SUPPORTED_BY_FORMAT

ReportCompactAnalysis7

One independently prompted analyst's structured output.

`created`可选string
`updated`可选string
`role`必填ReportAnalystRole	Which analyst produced this.
`summary`必填string \| null	One-paragraph summary; None only when prose_withheld.
`proseWithheld`可选boolean	True only where a public owner-costed read withheld this prose. 默认: `false`
`findings`可选ReportCompactFinding[]	Structured findings, strongest first. 默认: `[]`
`missingEvidence`可选string[]	Evidence this analyst says it lacked. 默认: `[]`

ReportCompactCitation5

One citation into an accepted artifact, without its artifact key.

`created`可选string
`updated`可选string
`phase`必填ReportPhase	Phase whose accepted artifact is cited.
`claim`必填string	The statement the artifact is cited for.
`strength`必填ReportEvidenceStrength	How strongly it supports.

ReportCompactConclusion9

The report's verdict in the smallest form a tool can reason over.

`created`可选string
`updated`可选string
`verdict`必填ReportVerdict	The business verdict reached.
`reasonCode`可选ReportReasonCode \| null	Closed-set reason; None only for SUITABLE.
`checkpoint`必填ReportPhase	Phase the verdict was reached at.
`policyRevision`可选string \| null	Frozen policy revision; owner reads only, never public.
`userReasoning`必填string \| null	Reader-facing explanation; None only when prose_withheld.
`proseWithheld`可选boolean	The adjudication's flag: True only where a public read of an owner-costed report withheld its prose. 默认: `false`
`isPartial`必填boolean	Whether the report closed before every phase ran.

ReportCompactCorroboration6

One piece of evidence supporting or extending the lifecycle window.

`created`可选string
`updated`可选string
`kind`必填ReportCorroborationKind	Which evidence class this is.
`statement`必填string	The concrete claim being made.
`sourceRef`必填string	Where the claim was observed.
`observedAt`可选string \| null	Instant the claim was observed, when known.

ReportCompactEconomics6

Market-level economics as a tool sees it.

`created`可选string
`updated`可选string
`determinateListingCount`必填integer	Listings with a defensible profit envelope.
`profitableListingCount`必填integer	Listings whose expected profit is positive.
`unresolvedListingCount`必填integer	Listings that could not be costed.
`successRates`可选ReportSuccessRateProjection \| null	Three-denominator market success rates.

ReportCompactEstimation5

How the report's material inputs were resolved.

`created`可选string
`updated`可选string
`verdictCounts`可选object	EstimateSource value -> member count.
`unresolvedCount`必填integer	Members with unresolved inputs.
`policyFingerprint`必填string	Digest of thresholds plus policies.

ReportCompactFinding5

One analyst finding with the citations it rests on.

`created`可选string
`updated`可选string
`headline`必填string	Short headline of the finding.
`reasoning`必填string	Reader-facing reasoning for the finding.
`citations`可选ReportCompactCitation[]	Citations supporting this finding. 默认: `[]`

ReportCompactGap6

One explicit hole a tool must report rather than fill in.

`created`可选string
`updated`可选string
`phase`必填ReportPhase	Phase with no accepted artifact.
`kind`必填ReportGapKind	Typed reason this phase is missing.
`detail`必填string	Reader-facing explanation.
`resumePhase`可选ReportPhase \| null	Phase a resumable gap restarts from.

ReportCompactLifecycle7

The market's lifecycle position as a tool sees it.

`created`可选string
`updated`可选string
`verdict`必填ReportLifecycleVerdict	Lifecycle position verdict.
`windowMonths`必填integer	Frozen lifecycle window in months.
`earliestEntryAgeMonths`可选integer \| null	Whole months since the earliest entry.
`corroborationCount`必填integer	Valid corroboration items supporting an extension.
`reasoning`必填string	Deterministic explanation of the verdict.

ReportCompactListing11

One comparable product as a tool sees it.

`created`可选string
`updated`可选string
`economicListingKey`必填string	Operational listing identity.
`representativeAsin`必填string	DISPLAY ONLY provider ASIN.
`memberAsins`可选string[]	DISPLAY ONLY member ASINs, for external lookup. 默认: `[]`
`outcome`必填ReportListingOutcome	Listing-level verdict.
`memberCount`必填integer	Members in the listing.
`familyEntryAgeMonths`可选integer \| null	Whole months since the family entered.
`expectedProfit`可选MinorUnitMoney \| null	Expected profit; None when not costed.
`marginLow`可选number \| null	Lower margin bound; None when not costed.
`marginHigh`可选number \| null	Upper margin bound; None when not costed.

ReportCompactMaterialGap6

One member whose material inputs could not be resolved, and why.

`created`可选string
`updated`可选string
`memberKey`可选string \| null	Member the gap belongs to, when member-scoped.
`economicListingKey`可选string \| null	Listing the gap belongs to, when listing-scoped.
`reason`必填string	Typed upstream gap reason.
`detail`必填string	Reader-facing explanation.

ReportCompactQuestion5

One material question this revision is waiting on an owner to answer.

`created`可选string
`updated`可选string
`economicListingKey`必填string	Listing the question is about.
`fields`可选ReportMaterialField[]	Which material inputs are being asked for. 默认: `[]`
`reason`必填string	Why the answer is needed.

ReportCompactSection可选值 · 6

The sections an agent query tool may ask a report for.

可选值: CONCLUSIONLISTINGSLIFECYCLEESTIMATIONECONOMICSGAPS

ReportCompactView15

Everything an agent query tool may read about one report.

`created`可选string
`updated`可选string
`version`必填ReportVersion	STORED report format identity.
`rootTaskId`必填string	Owning keble-task identity.
`revision`必填integer	Revision read; 0 for a V2 report.
`completeness`必填ReportCompleteness	Completeness at read time.
`amazonMarketplace`可选AmazonMarketplace \| null	Product-market the report analysed.
`updatedAt`可选string \| null	Instant the read revision was committed.
`conclusion`可选ReportCompactConclusion \| null	Verdict, when one was reached.
`listings`可选ReportCompactListing[]	Comparable products the report covered. 默认: `[]`
`lifecycle`可选ReportCompactLifecycle \| null	Market lifecycle position, when built.
`estimation`可选ReportCompactEstimation \| null	Material-input resolution, when built.
`economics`可选ReportCompactEconomics \| null	Market economics, when built.
`gaps`可选ReportCompactGap[]	Explicit holes still open in the report. 默认: `[]`
`absences`可选ReportCompactAbsence[]	Sections that are explicitly unavailable. 默认: `[]`

ReportCompleteness可选值 · 6

How complete the report is RIGHT NOW, as an explicit persisted fact.

可选值: PROCESSINGWAITING_FOR_INPUTPARTIAL_CONCLUDEDFULLCANCELLEDFAILED_PARTIAL

ReportConclusion12

The report's BUSINESS verdict with its full, auditable justification.

`created`可选string
`updated`可选string
`verdict`必填ReportVerdict	The business verdict reached.
`checkpoint`必填ReportPhase	Phase at which the verdict was reached.
`closure`必填ReportClosureKind	Whether this closure happened before the final phase.
`policyRevision`可选string \| null	Frozen policy revision; owner reads only, never public.
`reasonCode`可选ReportReasonCode \| null	Closed-set reason; None only for SUITABLE.
`userReasoning`必填string \| null	Reader-facing explanation of the verdict; None only when the adjudication's prose_withheld is True (owner-costed public read).
`evidenceRefs`可选ReportEvidenceRef[]	Citations into accepted artifacts. 默认: `[]`
`riskAnalysis`必填ReportRiskAnalysis	Independent risk analysis that fed the adjudication.
`opportunityAnalysis`必填ReportOpportunityAnalysis	Independent opportunity analysis that fed the adjudication.
`adjudication`必填ReportAdjudication	Structured adjudication that chose this outcome.

ReportConclusionEvidenceView9

The verdict PLUS the reasoning chain that produced it.

`created`可选string
`updated`可选string
`conclusion`必填ReportCompactConclusion	The verdict reached.
`citations`可选ReportCompactCitation[]	Citations the adjudicated verdict rests on. 默认: `[]`
`analyses`可选ReportCompactAnalysis[]	Risk and opportunity analyses, in that order. 默认: `[]`
`riskBlocksSuitability`必填boolean	Whether the risk analyst blocked a SUITABLE verdict.
`opportunitySupportsContinuation`必填boolean	Whether the opportunity analyst supported continuing.
`adjudicationCandidate`必填ReportAdjudicationCandidate	Outcome the adjudicator chose.
`overruledDissent`必填string	What the adjudicator overruled; empty when none.

ReportCorroborationKind可选值 · 2

The two independent evidence classes that may extend an older market.

可选值: REPEATED_USER_PAININNOVATION_ADDRESSES_PAIN

ReportDecisionType可选值 · 5

One question the report may park on for a typed agent answer.

可选值: REPORT_SCOPESAMPLE_RELEVANCEMATERIAL_FACTSSTANDOUT_SELECTIONJUDGMENT

ReportEstimateConfidence可选值 · 4

Confidence attached to one member's effective material range.

可选值: HIGHMEDIUMLOWUNRESOLVED

ReportEstimationEvidenceView7

How the report resolved its material inputs, and what stayed open.

`created`可选string
`updated`可选string
`estimation`必填ReportCompactEstimation	Resolution counts.
`unresolvedMemberKeys`可选string[]	Members whose material inputs stayed unresolved. 默认: `[]`
`excludedMemberKeys`可选string[]	Members excluded as mismatched. 默认: `[]`
`completenessGaps`可选ReportCompactMaterialGap[]	Typed holes in the material evidence. 默认: `[]`
`openQuestions`可选ReportCompactQuestion[]	Material questions awaiting an owner answer. 默认: `[]`

ReportEstimationMethodologyView6

Report-level record of how every material verdict was reached.

`created`可选string
`updated`可选string
`verdictCounts`可选object	EstimateSource value -> member count.
`excludedMismatchedMemberKeys`可选string[]	Internal member keys excluded as mismatched; owner reads only. 默认: `[]`
`completenessGaps`可选ReportMaterialGapView[]	Explicit unresolved holes. 默认: `[]`
`provenance`可选ReportEstimationProvenance \| null	Replay identity; owner reads only, never public.

ReportEstimationProvenance8

The REPLAY identity of one estimation revision — never reader content.

`created`可选string
`updated`可选string
`policyFingerprint`必填string	Digest of thresholds plus policies.
`researchFingerprint`必填string	Digest of the research selection.
`evidenceFingerprint`必填string	Digest of every evidence key used.
`completenessFingerprint`必填string	Digest of the completeness gaps.
`researchPolicyRevision`必填string	Frozen MaterialResearchSelectionPolicy revision.
`ownerResolutionFingerprint`可选string	Digest of the owner answers applied to this revision. 默认: `""`

ReportEvidenceQuery2

Ask for the evidence behind the verdict, the lifecycle or the estimation.

`object`可选string	可选值: `report_evidence` 默认: `"report_evidence"`
`topic`必填string	可选值: `CONCLUSIONLIFECYCLEESTIMATION`

ReportEvidenceRef6

A citation into ONE accepted artifact of this report.

`created`可选string
`updated`可选string
`phase`必填ReportPhase	Phase whose accepted artifact is cited.
`artifactKey`可选string \| null	Immutable artifact key; owner reads only, never public.
`claim`必填string	The concrete claim this artifact supports.
`strength`必填ReportEvidenceStrength	How strongly the cited artifact supports the claim.

ReportEvidenceStrength可选值 · 3

How strongly one cited artifact supports the statement that cites it.

可选值: WEAKMODERATESTRONG

ReportExcludedGroup5

One group of listings removed from the rate cohort, and why.

`created`可选string
`updated`可选string
`reason`必填string	Policy reason for the exclusion.
`count`必填integer	Listings removed for this reason.
`economicListingKeys`可选string[]	Operational identities of the removed listings. 默认: `[]`

ReportFamilyEntrySource可选值 · 3

Which observation class supplied a family's earliest credible entry.

可选值: MEMBER_RELEASEPARENT_RELATIONABSENT

ReportFinalOverviewSectionView6

The closing headline and summary of a fully built report.

`created`可选string
`updated`可选string
`kind`可选string	可选值: `FINAL_OVERVIEW` 默认: `"FINAL_OVERVIEW"`
`headline`必填string \| null	Reader-facing headline; None only when withheld.
`summary`必填string \| null	Reader-facing closing summary; None only when withheld.
`proseWithheld`可选boolean	True only where a public read withheld the overview prose. 默认: `false`

ReportGapDescriptor7

One EXPLICIT hole in the report, with the reason it is a hole.

`created`可选string
`updated`可选string
`phase`必填ReportPhase	Phase with no accepted artifact.
`kind`必填ReportGapKind	Typed reason this phase is missing.
`detail`必填string	Reviewer-visible explanation of the gap.
`awaitingInputKey`可选string \| null	Stable key of the input this gap waits on.
`resumePhase`可选ReportPhase \| null	Phase the backend should run to continue.

ReportGapKind可选值 · 5

Why one phase has no accepted artifact yet.

可选值: PENDINGWAITING_FOR_INPUTSKIPPEDFAILEDCONTINUABLE

ReportJudgmentAnswer4

The create-time conclusion for one revision (07a §2.1).

`decisionType`可选string	可选值: `JUDGMENT` 默认: `"JUDGMENT"`
`verdict`可选ReportJudgmentVerdict \| null	Required iff the question's verdict is open.
`sections`必填ReportJudgmentSection[]	Exactly the question's section kinds, once each.
`overview`必填ReportOverviewEvidence	Headline and summary.

ReportJudgmentEvidenceItem3

One citable accepted artifact: its block from build_evidence_digest.

`itemKey`必填string	The artifact_key a ReportEvidenceRef cites.
`phase`必填ReportPhase	Phase of the cited artifact.
`evidence`必填string	Rendered evidence block.

ReportJudgmentQuery1

Ask for the HEAD revision's conclusion question, so an agent can cite it.

object可选string

可选值: report_judgment

默认: "report_judgment"

ReportJudgmentSection2

One old-page interpretation slot's text; number-free.

`sectionKind`必填ReportNarrativeSectionKind	Old-page slot.
`body`必填string	Number-free reader text.

ReportJudgmentVerdict3

The three analyses one agent now writes.

`riskAnalysis`必填ReportRiskAnalysis	Risk analysis.
`opportunityAnalysis`必填ReportOpportunityAnalysis	Opportunity analysis.
`adjudication`必填ReportAdjudication	Candidate, reason code and citations.

ReportLengthUnit可选值 · 2

The length units a material question may be asked and answered in.

可选值: CENTIMETREINCH

ReportLifecycleEvidenceView8

The market's lifecycle position PLUS the evidence behind the verdict.

`created`可选string
`updated`可选string
`lifecycle`必填ReportCompactLifecycle	Lifecycle position.
`evaluatedAt`必填string	Frozen instant ages were measured at.
`earliestEntryAt`可选string \| null	Earliest credible family entry, when known.
`contributingListingKeys`可选string[]	Listings that fixed the earliest entry. 默认: `[]`
`corroboration`可选ReportCompactCorroboration[]	Evidence supporting or extending the window. 默认: `[]`
`droppedCorroborationCount`可选integer \| null	Search results not retained; None for historical artifacts.

ReportLifecycleVerdict可选值 · 4

Where the market sits against the frozen lifecycle window.

可选值: WITHIN_WINDOWBEYOND_WINDOW_CORROBORATEDBEYOND_WINDOW_UNCORROBORATEDENTRY_UNKNOWN

ReportListingCohortSectionView18

The competitor cohort of ONE revision, ready for the old-report layout.

`created`可选string
`updated`可选string
`kind`可选string	可选值: `LISTING_BUILD` 默认: `"LISTING_BUILD"`
`evaluatedAt`必填string	Frozen INPUT_FREEZE evaluation instant.
`memberCount`必填integer	Population ASIN members.
`excludedMemberCount`必填integer	Loaded market members excluded by policy.
`newReleaseCount`必填integer	Population new releases.
`economicsReady`必填boolean	Whether LISTING_ECONOMICS is accepted.
`marginAll`可选ReportCohortMarginDistribution \| null	Every population member; by_resolved_sales puts an unresolved sale in OTHER, by_known_margin only a missing margin.
`marginNew`可选ReportCohortMarginDistribution \| null	Population new releases; by_resolved_sales puts an unresolved sale in OTHER, by_known_margin only a missing margin.
`rankTables`可选ReportCohortRankTable[]	Four profit rankings in key order. 默认: `[]`
`timelineYearly`可选ReportCohortPeriodCount[]	New releases per UTC calendar year, oldest first. 默认: `[]`
`timelineMonthly`可选ReportCohortPeriodCount[]	New releases per UTC calendar month, oldest first. 默认: `[]`
`brandScopes`可选ReportCohortBrandScopeView[]	ALL, NEW_BRANDS and OLD_BRANDS, in that order. 默认: `[]`
`oldBrandNewReleaseShare`必填ReportSuccessRate	OLD_BRANDS new releases / ALL new releases.
`brands`可选ReportCohortBrandRow[]	Brands by member count desc, then name. 默认: `[]`
`standoutCases`可选ReportCohortStandoutCase[] \| null	None = no STANDOUT artifact; () = ran with no picks.
`subject`可选ReportCohortSubjectDisplay \| null	Subject product display facts; None when not loaded.

ReportListingDetailView7

One listing with its members, evidence counts, and economics.

`created`可选string
`updated`可选string
`summary`必填ReportListingSummaryView	The paged summary view.
`members`必填ReportListingMemberView[]	Every projected member of this listing.
`outcomeReasoning`必填string	Deterministic explanation of the listing verdict.
`groupingEvidenceCount`必填integer	Number of retained pair-scoring evidence records.
`economics`可选ReportListingEconomicsView \| null	Listing economics when the phase produced them.

ReportListingEconomicsView10

The economics of ONE listing, with scenario ranges kept honest.

`created`可选string
`updated`可选string
`economicListingKey`必填string	Operational listing identity.
`sellingPrice`可选ReportMoneyPoint \| null	Observed selling price of the representative.
`profit`可选ReportMoneyEnvelope \| null	Profit envelope; None when inputs are unresolved.
`purchasingCost`可选ReportPurchasingCostView \| null	Effective purchasing cost with its authorisation.
`margin`可选ReportRatioRange \| null	Margin range with its explicit range kind.
`scenarios`可选ProfitEnvelope \| null	Every coherent scenario waterfall, verbatim.
`sizing`可选ReportListingSizingView \| null	Physical size and fee tier behind the scenarios.
`unresolvedDetail`可选string \| null	Why this listing has no economics, when it has none.

ReportListingMemberKind可选值 · 2

Whether a projected member was actually loaded from the provider.

可选值: LOADEDPLACEHOLDER

ReportListingMemberView10

One member of an economic listing, projected for display and citation.

`created`可选string
`updated`可选string
`memberKey`必填string	Operational member identity.
`asin`必填string	DISPLAY ONLY provider ASIN.
`kind`必填ReportListingMemberKind	LOADED or PLACEHOLDER.
`isRepresentative`必填boolean	Whether this member is the listing's representative.
`excludedReason`可选string \| null	Policy exclusion reason, when excluded.
`excludedDetail`可选string \| null	Reviewer-visible exclusion explanation.
`releasedAt`可选string \| null	Credible observed release instant.
`ageMonths`可选integer \| null	Whole months since this member's release.

ReportListingOutcome可选值 · 3

Whether a listing proves success, proves a failed launch, or neither.

可选值: SUCCESSNEW_RELEASE_FAILEDNOT_DETERMINABLE

ReportListingPage5

One cursor page of listing summaries.

`created`可选string
`updated`可选string
`items`必填ReportListingSummaryView[]	Ordered listing summaries in this page.
`nextCursor`可选string \| null	Opaque cursor for the next page; None at the end.
`totalKnown`必填integer	Total listings known at the read revision.

ReportListingQuery2

Ask for the one listing that CONTAINS an Amazon ASIN.

`object`可选string	可选值: `report_listing` 默认: `"report_listing"`
`asin`必填string	Any member ASIN.

ReportListingSizingView9

What the report shows about ONE listing's physical size and fee tier.

`created`可选string
`updated`可选string
`accepted`必填SizingDetail	Sizing the expected scenario used.
`materialBounds`可选ReportMaterialBoundsView \| null	Accepted low/high physical correction range.
`materialSource`可选EstimateSource \| null	Provenance of the accepted correction.
`materialConfidence`可选ReportEstimateConfidence \| null	Confidence of the accepted correction.
`anomalyHeadlines`可选string[]	Typed anomaly labels observed for this listing. 默认: `[]`
`tierProbeSizeTiers`可选string[]	Size tiers of the retained fee-tier probes. 默认: `[]`
`reasoning`可选string \| null	Deterministic explanation of the accepted size.

ReportListingSummaryView25

A listing as it appears in a paged list, for ONE audience at a time.

`created`可选string
`updated`可选string
`economicListingKey`可选string \| null	Internal listing identity; owner reads only, never public.
`publicListingHandle`可选string \| null	Opaque public listing reference; public reads only.
`representativeMemberKey`可选string \| null	Internal member identity; owner reads only, never public.
`representativeAsin`必填string	DISPLAY ONLY provider ASIN.
`representativeQuality`必填ReportRepresentativeQuality	Whether a real sales signal chose the representative.
`marketplace`可选AmazonMarketplace \| null	Product marketplace this listing was analysed in.
`outcome`必填ReportListingOutcome	Listing-level success verdict.
`memberCount`必填integer	All members of the listing.
`loadedMemberCount`必填integer	Members loaded from provider.
`excludedMemberCount`必填integer	Members excluded by policy.
`familyEntryAt`可选string \| null	Earliest credible family entry instant.
`familyEntryAgeMonths`可选integer \| null	Whole months since the family entered.
`familyEntrySource`必填ReportFamilyEntrySource	Which observation supplied the family entry.
`sellingPrice`可选MinorUnitMoney \| null	Expected-scenario selling price; None until costed.
`monthlySold`可选integer \| null	Representative member's latest observed monthly units.
`expectedProfit`可选MinorUnitMoney \| null	Expected-scenario profit; None until costed.
`margin`可选number \| string \| null	Expected-scenario margin ratio; None until costed.
`title`可选string \| null	Representative member's provider title, read-time.
`brand`可选string \| null	Representative member's provider brand, read-time.
`imageUrl`可选string \| null	Representative member's primary image; None before 2.62.0.
`profitableCostBasis`可选ReportPurchasingCostProvenance \| null	Purchase-cost provenance the profitable flag was priced with; stored at LISTING_BUILD, None before 2.62.0.
`economicsCostBasis`可选ReportPurchasingCostProvenance \| null	Purchase-cost provenance the expected scenario used, owner answers included; read-time, None without economics.
`profitWithheld`可选boolean	True only on a public owner-costed read, where per-row profit and margin are withheld rather than absent. 默认: `false`

ReportListingsQuery2

Ask for one cursor page of the report's comparable listings.

`object`可选string	可选值: `report_listings` 默认: `"report_listings"`
`cursor`可选string \| null	Previous page's next cursor.

ReportMarketSectionView6

The market's success rates and the capital needed to enter it.

`created`可选string
`updated`可选string
`kind`可选string	可选值: `MARKET_SUCCESS_INVESTMENT` 默认: `"MARKET_SUCCESS_INVESTMENT"`
`successRates`必填ReportSuccessRateProjection	Three-denominator market success rates.
`entryInvestment`可选ReportMoneyPoint \| null	Entry investment point plus peer benchmark.
`marginBenchmark`可选ReportRatioRange \| null	Peer margin benchmark for the covered cohort.

ReportMassUnit可选值 · 2

The mass units a material question may be asked and answered in.

可选值: GRAMKILOGRAM

ReportMaterialBoundsView12

The effective low/high physical and purchasing-cost bounds of a member.

`created`可选string
`updated`可选string
`lowLengthCm`可选number \| null	Lower length bound.
`lowWidthCm`可选number \| null	Lower width bound.
`lowHeightCm`可选number \| null	Lower height bound.
`lowWeightG`可选number \| null	Lower weight bound.
`highLengthCm`可选number \| null	Upper length bound.
`highWidthCm`可选number \| null	Upper width bound.
`highHeightCm`可选number \| null	Upper height bound.
`highWeightG`可选number \| null	Upper weight bound.
`lowUnitCost`可选MinorUnitMoney \| null	Lower purchasing unit cost bound.
`highUnitCost`可选MinorUnitMoney \| null	Upper purchasing unit cost bound.

ReportMaterialCostAnswer2

One purchasing unit cost, as a point or an inclusive range.

`low`必填MinorUnitMoney	Lower purchasing unit cost bound.
`high`必填MinorUnitMoney	Upper purchasing unit cost bound.

ReportMaterialDimensionsAnswer4

The three physical axes of one product, with the unit they are in.

`unit`必填ReportLengthUnit	Unit the three axes are given in.
`length`必填number	Longest axis, in unit.
`width`必填number	Second axis, in unit.
`height`必填number	Third axis, in unit.

ReportMaterialEstimateView12

One member's effective material range with its provenance.

`created`可选string
`updated`可选string
`estimateKey`必填string	Stable identity of the upstream estimate.
`memberKey`必填string	Operational member identity.
`economicListingKey`必填string	Operational listing identity.
`source`必填EstimateSource	Where the effective range came from.
`confidence`必填ReportEstimateConfidence	Confidence in the range.
`unitCostSource`可选EstimateSource \| null	Where the purchasing cost came from, if judged.
`unitCostConfidence`可选ReportEstimateConfidence \| null	Confidence in the purchasing cost, if judged.
`bounds`必填ReportMaterialBoundsView	Effective low/high bounds.
`anomalyHeadlines`可选string[]	Typed anomaly labels observed for this member. 默认: `[]`
`reasoning`必填string	Deterministic explanation of the verdict.

ReportMaterialField可选值 · 5

One physical or cost input a report may have to ask its owner about.

可选值: LENGTHWIDTHHEIGHTWEIGHTUNIT_COST

ReportMaterialGapView6

One explicitly reported hole in the material picture.

`created`可选string
`updated`可选string
`memberKey`可选string \| null	Internal member identity; owner reads only, never public.
`economicListingKey`可选string \| null	Internal listing identity; owner reads only, never public.
`reason`必填string	Typed upstream gap reason.
`detail`必填string	Inputs still unmeasured and excluded from profit figures.

ReportMaterialQuestion12

One economic listing's unresolved material facts and safe choices.

`created`可选string
`updated`可选string
`questionKey`必填string	Stable question identity.
`economicListingKey`必填string	Operational listing identity.
`fields`必填ReportMaterialField[]	Inputs the answer must supply.
`lengthUnit`可选ReportLengthUnit	Unit a dimensions answer must be given in. 默认: `"CENTIMETRE"`
`massUnit`可选ReportMassUnit	Unit a weight answer must be given in. 默认: `"GRAM"`
`currency`可选Currency \| null	Currency a cost answer must be given in.
`observed`可选ReportMaterialEstimateView \| null	The estimate that is missing these inputs.
`analysed`可选ReportMaterialBoundsView \| null	The analysis's own low/high bounds for a disputed input; None when the analysis never established a range.
`suggestedResolutions`可选ReportMaterialResolution[]	Server suggestions the owner may pick. 默认: `[]`
`reason`必填string	Reviewer-visible reason the answer is needed.

ReportMaterialResolution5

ONE typed answer to ONE material question.

`source`必填ReportMaterialResolutionSource	Whether the owner picked a suggestion or typed values.
`suggestionKey`可选string \| null	Stable key of the picked server suggestion.
`dimensions`可选ReportMaterialDimensionsAnswer \| null	Typed three-axis answer, when supplied.
`weight`可选ReportMaterialWeightAnswer \| null	Typed weight answer, when supplied.
`unitCost`可选ReportMaterialCostAnswer \| null	Typed purchasing unit cost answer, when supplied.

ReportMaterialResolutionSource可选值 · 2

Where one owner answer came from.

可选值: SERVER_SUGGESTIONOWNER_ENTERED

ReportMaterialWeightAnswer2

One product's weight, with the unit it is expressed in.

`unit`必填ReportMassUnit	Unit the weight is given in.
`weight`必填number	Product weight, in unit.

ReportMoneyEnvelope5

An expected value with a DEFENSIBLE scenario range around it.

`created`可选string
`updated`可选string
`expected`必填MinorUnitMoney	Expected-scenario value.
`bounds`必填ReportMoneyRange	Pessimistic/optimistic bounds.
`boundScenarioKeys`必填any[]	Frozen scenario keys that produced the low and high bounds.

ReportMoneyPoint4

One money value, optionally accompanied by a LABELLED peer benchmark.

`created`可选string
`updated`可选string
`value`必填MinorUnitMoney	The single defensible value.
`benchmark`可选ReportMoneyRange \| null	Separately labelled peer comparison range.

ReportMoneyRange7

A money low/high pair that always states what kind of range it is.

`created`可选string
`updated`可选string
`low`必填MinorUnitMoney	Lower bound.
`high`必填MinorUnitMoney	Upper bound.
`kind`必填ReportRangeKind	Scenario bound or cohort benchmark.
`cohortLabel`可选string \| null	Peer cohort described; required for a benchmark.
`cohortSize`可选integer \| null	Peer cohort size; required for a benchmark.

ReportNarrativeSection6

One rendered narrative section keyed by the phase it explains.

`created`可选string
`updated`可选string
`sectionKey`必填string	Stable section identity.
`sourcePhase`必填ReportPhase	Phase whose artifact it explains.
`body`必填string \| null	Reader-facing prose; None only when prose_withheld.
`proseWithheld`可选boolean	True only where a public read withheld this section's prose. 默认: `false`

ReportNarrativeSectionKind可选值 · 5

The FIVE old-page interpretation slots the report's prose fills (07a §2.3).

可选值: INVESTMENT_BUDGETINVESTMENT_BRANDSPROFIT_RATIOSMARKET_NEW_PRODUCTSMARKET_ENTRY_TIMING

ReportNarrativeSectionView4

The rendered prose sections in display order.

`created`可选string
`updated`可选string
`kind`可选string	可选值: `NARRATIVE` 默认: `"NARRATIVE"`
`sections`必填ReportNarrativeSection[]	Rendered narrative sections in display order.

ReportOpportunityAnalysis7

Independent OPPORTUNITY analysis of the accepted artifacts.

`created`可选string
`updated`可选string
`findings`可选ReportAnalystFinding[]	Concrete opportunities, each with citations. 默认: `[]`
`missingEvidence`可选string[]	Evidence the analyst needed but did not find in the artifacts. 默认: `[]`
`supportsContinuation`必填boolean	Whether the opportunities justify continuing the analysis.
`summary`必填string \| null	One-paragraph opportunity summary.
`proseWithheld`可选boolean	True only where a public read withheld this analysis' prose. 默认: `false`

ReportOverviewEvidence2

Closing headline and summary for the FINAL_OVERVIEW phase.

`headline`必填string	Reader-facing headline.
`summary`必填string	Reader-facing closing summary.

ReportOverviewQuery1

Ask for the report's typed, absence-complete overview.

object可选string

可选值: report_overview

默认: "report_overview"

ReportPhase可选值 · 14

The ordered phases a V3 report walks; each produces exactly one artifact.

可选值: INPUT_FREEZESOURCE_LOADSAMPLE_RELEVANCELISTING_BUILDSIMILARITY_COVERAGEMATERIAL_TRIAGEENTRY_LIFECYCLEREVIEW_COMPETITIONLISTING_ECONOMICSMARKET_SUCCESS_INVESTMENTSTANDOUTDECISION_CHECKPOINTNARRATIVEFINAL_OVERVIEW

ReportProfileEconomicFields10

The seller-setup fields that map onto a run's frozen economic premise.

`suggestedPurchasingCost`可选SuggestedPurchasingCost \| null	The seller's own purchasing cost for one benchmark ASIN; never a Keble estimate.
`acosLowerbound`可选integer \| null	ACOS lower bound, whole percent.
`acosUpperbound`可选integer \| null	ACOS upper bound, whole percent.
`fixedLength`可选number \| null	Fixed length.
`fixedWidth`可选number \| null	Fixed width.
`fixedHeight`可选number \| null	Fixed height.
`fixedLengthUnit`可选string \| null	Unit of the fixed size; None means cm.
`fixedWeight`可选number \| null	Fixed weight.
`fixedWeightUnit`可选string \| null	Unit of the fixed weight; None means g.
`investmentDifficultyAmountThreshold`可选MinorUnitMoney \| null	Entry-budget threshold.

ReportPurchasingCostProvenance可选值 · 2

WHERE one priced listing's effective purchase cost came from.

可选值: USER_SUPPLIEDCOHORT_INFERRED

ReportPurchasingCostView8

The expected purchasing cost plus the evidence that AUTHORISED it.

`created`可选string
`updated`可选string
`amount`必填ReportMoneyPoint	Settled expected purchasing cost.
`source`必填EstimateSource	Provenance of the costed line.
`estimateKey`可选string \| null	Material estimate that authorised the amount.
`confidence`可选ReportEstimateConfidence \| null	Confidence of the authorising material estimate.
`bounds`可选ReportMoneyRange \| null	Low/high unit-cost range the estimate allowed.
`reason`可选string \| null	Deterministic reasoning behind the amount.

ReportRangeKind可选值 · 2

Whether a range describes THIS product or a peer cohort.

可选值: SCENARIO_BOUNDCOHORT_BENCHMARK

ReportRateAbsenceReason可选值 · 2

Why a cohort rate is a typed absence rather than a percentage.

可选值: NO_ELIGIBLE_LISTINGNO_DETERMINATE_LISTING

ReportRatioRange8

A unitless low/high pair (for example a margin) with its range kind.

`created`可选string
`updated`可选string
`low`必填number	Lower bound as a unitless ratio.
`high`必填number	Upper bound as a unitless ratio.
`kind`必填ReportRangeKind	Scenario bound or cohort benchmark.
`cohortLabel`可选string \| null	Peer cohort described; required for a benchmark.
`cohortSize`可选integer \| null	Peer cohort size; required for a benchmark.
`boundScenarioKeys`可选any[] \| null	Frozen scenario keys behind low/high; required for a bound.

ReportReasonCode可选值 · 7

The closed set of reasons a report did not end SUITABLE.

可选值: INSUFFICIENT_SIMILAR_LISTINGSMATERIAL_INPUT_UNRESOLVEDNO_QUALIFYING_LAUNCH_EVIDENCEEVIDENCE_CONFLICTSUSTAINED_UNPROFITABLE_MARKETNEW_RELEASE_FAILEDCOMPETITION_OR_INVESTMENT_UNSUITABLE

ReportRepresentativeQuality可选值 · 2

Whether the representative was chosen from a real sales signal.

可选值: KNOWNUNKNOWN

ReportRetryEligibility可选值 · 3

Whether a terminated run may be retried, and by whom.

可选值: RETRYABLERETRYABLE_AFTER_INPUT_CHANGENOT_RETRYABLE

ReportRiskAnalysis7

Independent RISK analysis of the accepted artifacts.

`created`可选string
`updated`可选string
`findings`可选ReportAnalystFinding[]	Concrete risks, each with citations. 默认: `[]`
`missingEvidence`可选string[]	Evidence the analyst needed but did not find in the artifacts. 默认: `[]`
`blockingUnsuitable`必填boolean	Whether the risks alone would close the report unsuitable.
`summary`必填string \| null	One-paragraph risk summary.
`proseWithheld`可选boolean	True only where a public read withheld this analysis' prose. 默认: `false`

ReportScopeAnswer3

Store a category and the exact keyword text supplied for a report scope.

`decisionType`可选string	可选值: `REPORT_SCOPE` 默认: `"REPORT_SCOPE"`
`categoryId`必填integer	Confirmed category id.
`keywords`可选string[]	Stored keyword text; a NEW REPORT_SCOPE answer needs at least one owner-confirmed, non-blank keyword. 默认: `[]`

ReportScopeCandidate3

One category candidate the agent may confirm for the report scope.

`categoryId`必填integer	Candidate Amazon category node id.
`categoryName`必填string	Readable category name.
`keywords`可选string[]	Empty: candidate discovery supplies no keywords. 默认: `[]`

ReportSectionKind可选值 · 4

The EXACT set of report sections a reader may request.

可选值: LISTING_BUILDMARKET_SUCCESS_INVESTMENTNARRATIVEFINAL_OVERVIEW

ReportSectionQuery2

Ask for one written section (market numbers, narrative, final overview).

`object`可选string	可选值: `report_section` 默认: `"report_section"`
`section`必填ReportSectionKind

ReportStandoutMarketTraits7

The old report's market traits the agent may attach to its standout choice.

`newProfitableMustPrivateMold`必填boolean	True if profitable products generally have different designs from old market products (private mold / owned design, not common public molds); False if at least some profitable products (>=2) are likely public mold/common designs compared to old products. If no profitable products are provided, decide based on old market products.
`newProfitableSignificantRnd`必填boolean	True if most profitable products require significant early-stage R&D (e.g., mold, design, technology, mobile app, patent); otherwise False. If no profitable products are provided, decide based on old market products.
`newProfitableHasBattery`必填boolean	True if products explicitly include a lithium battery in the package; power adapter or rechargeable usage alone does not count. If no profitable products are provided, decide based on old market products.
`newProfitableHasBluetooth`必填boolean	True if products have Bluetooth; otherwise False. If no profitable products are provided, decide based on old market products.
`newProfitableChildrenProduct`必填boolean	True if products target children and are categorized as children products; otherwise False. If no profitable products are provided, decide based on old market products.
`productDiversity`必填LlmProductDiversity	How standardized the category is and how much design matters.
`productAlternatives`可选string[]	Alternatives a buyer would weigh; ten at most. 默认: `[]`

ReportStandoutPick2

ONE chosen standout product, mirroring the legacy unique-product output.

`itemKey`必填string	Chosen listing identity.
`reason`必填string	Why this product stands out, in judgements and names only; never quote figures.

ReportSuccessRate6

One success rate with its explicit numerator, denominator, or absence.

`created`可选string
`updated`可选string
`value`可选number \| null	Rate in [0, 1]; None when absent.
`numerator`必填integer	Listings counted in the numerator.
`denominator`必填integer	Listings counted in the denominator.
`absenceReason`可选ReportRateAbsenceReason \| null	Typed reason the rate has no value.

ReportSuccessRateProjection11

The three cohort success rates plus everything excluded from them.

`created`可选string
`updated`可选string
`eligibleCount`必填integer	Listings with an eligible member.
`successCount`必填integer	Eligible listings proving success.
`failureCount`必填integer	Eligible listings proving failure.
`unresolvedCount`必填integer	Eligible listings proving neither.
`robust`必填ReportSuccessRate	successes / all eligible listings.
`expected`必填ReportSuccessRate	successes / determinate listings.
`possible`必填ReportSuccessRate	(successes + unresolved) / all eligible listings.
`excludedCount`必填integer	Listings removed by policy.
`excludedGroups`可选ReportExcludedGroup[]	Removed listings grouped by policy reason. 默认: `[]`

ReportTerminalState8

Why a run stopped operationally, with the last durable revision.

`created`可选string
`updated`可选string
`status`必填ReportTerminalStatus	Operational stop status.
`reason`必填string	Internal, reviewer-facing reason.
`userMessage`必填string	Reader-facing message safe to display.
`committedRevision`必填integer	Last committed revision; 0 when nothing was committed.
`retryEligibility`必填ReportRetryEligibility	Whether and how this run may be retried.
`failedPhase`可选ReportPhase \| null	Phase that failed; required for FAILED_PARTIAL.

ReportTerminalStatus可选值 · 2

Operational ways a run stops WITHOUT a business verdict.

可选值: CANCELLEDFAILED_PARTIAL

ReportUnitDescriptor6

One phase artifact that is READY and safe to render.

`created`可选string
`updated`可选string
`phase`必填ReportPhase	Phase that produced the ready unit.
`artifactKey`可选string \| null	Immutable artifact id; owner reads only, never public.
`revision`必填integer	Revision the artifact was committed in.
`committedAt`必填string	Instant the artifact was committed.

ReportV3ConclusionToolResult7

One V3 report's verdict plus its reasoning chain, or a typed absence.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_conclusion` 默认: `"report_v3_conclusion"`
`consultedRevision`必填integer	Revision this answer read.
`latestRevision`必填integer	Latest committed revision.
`view`可选ReportConclusionEvidenceView \| null	Verdict and reasoning; None when not reached.
`absence`可选ReportCompactAbsence \| null	Typed reason no verdict exists at this revision.

ReportV3EstimationToolResult7

One V3 report's material-estimation evidence, or a typed absence.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_estimation` 默认: `"report_v3_estimation"`
`consultedRevision`必填integer	Revision this answer read.
`latestRevision`必填integer	Latest committed revision.
`view`可选ReportEstimationEvidenceView \| null	How material inputs were resolved.
`absence`可选ReportCompactAbsence \| null	Typed reason the methodology is unavailable.

ReportV3JudgmentToolResult6

One V3 report's head conclusion question, pinned to the revision read.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_judgment` 默认: `"report_v3_judgment"`
`consultedRevision`必填integer	Revision this answer read.
`latestRevision`必填integer	Latest committed revision.
`question`必填JudgmentQuestion	The head's conclusion question.

ReportV3LifecycleToolResult7

One V3 report's lifecycle evidence, or a typed absence.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_lifecycle` 默认: `"report_v3_lifecycle"`
`consultedRevision`必填integer	Revision this answer read.
`latestRevision`必填integer	Latest committed revision.
`view`可选ReportLifecycleEvidenceView \| null	Lifecycle verdict and corroboration.
`absence`可选ReportCompactAbsence \| null	Typed reason the lifecycle is unavailable.

ReportV3ListingDetailToolResult5

One economic listing's members and economics at a revision.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_listing_detail` 默认: `"report_v3_listing_detail"`
`consultedRevision`必填integer	Revision this answer read.
`detail`必填ReportListingDetailView	Listing detail view.

ReportV3ListingsToolResult5

One cursor page of a V3 report's comparable listings at a revision.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_listings` 默认: `"report_v3_listings"`
`consultedRevision`必填integer	Revision this answer read.
`page`必填ReportListingPage	Ordered listing summaries.

ReportV3OverviewToolResult6

One V3 report's typed facts at the exact revision that was consulted.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_overview` 默认: `"report_v3_overview"`
`consultedRevision`必填integer	Revision this answer read.
`latestRevision`必填integer	Latest committed revision.
`view`必填ReportCompactView	Typed, absence-complete facts.

ReportV3SectionToolResult6

One display-safe written section of a V3 report, or its typed gap.

`created`可选string
`updated`可选string
`object`可选string	可选值: `report_v3_section` 默认: `"report_v3_section"`
`consultedRevision`必填integer	Revision this answer read.
`section`可选ReportListingCohortSectionView \| ReportMarketSectionView \| ReportNarrativeSectionView \| ReportFinalOverviewSectionView \| null	Display-safe section view; None when not built.
`absence`可选ReportGapDescriptor \| null	Typed gap of a section this revision has not built.

ReportVerdict可选值 · 3

The three business verdicts a V3 report may reach.

可选值: SUITABLENOT_SUITABLENOT_DETERMINABLE

ReportVersion可选值 · 2

Persisted report FORMAT identity, read from storage and never inferred.

可选值: 2.0.03.0.0

ResizeDesign5

Move an OWN image to another preset (e.g. secondary 2000x2000 -> A+ header 970x600).

`action`可选string	可选值: `RESIZE_DESIGN` 默认: `"RESIZE_DESIGN"`
`designId`必填string
`preset`必填string	可选值: `amazon.aplus.banneramazon.aplus.comparisonamazon.aplus.four_imageamazon.aplus.headeramazon.aplus.logoamazon.aplus.quadrantamazon.aplus.singleamazon.aplus_premium.full_widthamazon.brand_story.backgroundamazon.brand_story.cardamazon.mainamazon.secondarycustomshopify.blog_featuredshopify.collectionshopify.product`
`size`可选PixelSize \| null
`mode`必填ResizeMode

ResizeMode可选值 · 2

How layers follow a canvas resize (the Magic-Resize choice; also a variant recipe's fit).

可选值: SCALE_TO_FITREFLOW

Resolution可选值 · 5

Who resolves an issue, derived from its kind and permission.

可选值: RECONNECTFIX_AT_PROVIDERWAITSUPPORTCHECK_REQUEST

ResolvedWindow2

ONE resolved time window: its axis and the span it was resolved to.

`axis`必填TimeAxis	Which instant the window is measured on.
`span`必填DateWindow	The resolved inclusive span.

RestoreRow2

Bring a discarded row back into the next proposal.

`op`可选string	可选值: `RESTORE_ROW` 默认: `"RESTORE_ROW"`
`rowKey`必填string

ResumeStoreRequest1

One store, addressed by its id.

storeId必填string

The store's id.

RevertFidelity可选值 · 3

How completely an action can be undone, shown on every action diff.

可选值: EXACTBEST_EFFORTNONE

RevertLink2

Identify the apply-record row a revert action undoes.

`actionKey`必填string	Revert action row key.
`recordId`必填string	Apply record being reverted.

RevertRequest4

Ask the service to construct the undo of one proposal; callers choose rows, never undo values.

`proposalId`必填string	Proposal to revert.
`actionKeys`可选string[]	Optional rows to revert; empty means every revertible row. 默认: `[]`
`replayKey`可选string \| null	Caller-owned idempotency key.
`attribution`可选ProposalAttribution \| null	Origin and reason of this undo; excluded from its hash.

RevokeReach可选值 · 2

Whether removing a connection also asks the provider to withdraw access.

可选值: PROVIDERLOCAL

RoomCell2

One rendered cell: the computed cell plus its stored score and tier (None when unscored).

`cell`必填Cell
`score`可选CellScore \| null

RoomPublicAssessment5

One declared judgement as a customer sees it, without its model brief or dependencies.

`object`可选string	可选值: `room_assessment` 默认: `"room_assessment"`
`key`必填string
`label`必填LocalizedText
`kind`必填AssessmentKind
`ranges`可选AssessmentRange[]	默认: `[]`

RoomPublicDecisionOffer4

Whether a decision run can start, without the internal decision-input size.

`object`可选string	可选值: `room_decision_offer` 默认: `"room_decision_offer"`
`eligible`必填boolean
`refusal`可选DecisionRefusal \| null
`offeredCells`可选integer	默认: `0`

RoomPublicDecisionRead5

The decision read a customer sees, with request_chars dropped.

`object`可选string	可选值: `room_decision` 默认: `"room_decision"`
`scorecard`可选RoomPublicScorecard \| null
`decision`可选DecisionRecord \| null
`offer`必填RoomPublicDecisionOffer
`scoredCells`可选RoomCell[]	默认: `[]`

RoomPublicDeclaration13

One plugin declaration as a customer room renders it.

`object`可选string	可选值: `room_declaration` 默认: `"room_declaration"`
`pluginId`必填string
`title`必填LocalizedText
`description`必填LocalizedText
`itemNoun`必填LocalizedText
`setup`必填SetupField[]
`facts`必填FactSpec[]
`measures`必填RoomPublicMeasure[]
`assessments`必填RoomPublicAssessment[]
`dimensions`必填RoomPublicDimensions
`grid`必填GridSpec
`detail`必填DetailSection[]
`itemCard`必填ItemCardSpec

RoomPublicDimensions2

Which dimensions a positioning may use, without the classifier brief.

`object`可选string	可选值: `room_dimensions` 默认: `"room_dimensions"`
`computed`可选BandedDimension[]	默认: `[]`

RoomPublicMeasure4

One declared measure as a customer sees it, without its computation rule.

`object`可选string	可选值: `room_measure` 默认: `"room_measure"`
`key`必填string
`label`必填LocalizedText
`format`必填MeasureFormat

RoomPublicPositioning10

The customer-visible half of one positioning record.

`object`可选string	可选值: `room_positioning` 默认: `"room_positioning"`
`positioningId`必填string
`taskId`必填string
`gridId`可选string \| null
`pluginId`必填string
`language`必填Language
`brief`必填string
`phase`必填Phase
`status`必填PhaseStatus
`createdAt`必填string

RoomPublicRead8

Everything the customer room renders, with the plugin declaration projected safe.

`object`可选string	可选值: `room` 默认: `"room"`
`positioning`必填RoomPublicPositioning
`declaration`必填RoomPublicDeclaration
`viewport`必填Viewport
`view`必填ViewDefinition
`dimensions`必填DimensionRecord[]
`criteria`必填CriterionRecord[]
`cells`必填RoomCell[]

RoomPublicScorecard6

One stored scorecard as a customer sees it, without request_chars.

`object`可选string	可选值: `room_scorecard` 默认: `"room_scorecard"`
`profile`必填string
`cells`必填CellScore[]
`excluded`可选string[]	默认: `[]`
`threshold`可选integer	默认: `60`
`scoredAt`必填string

RouteHints5

The pinned read preferences carried with a public question.

`channel`可选Channel \| null	Channel pinned for the question; null lets the router choose.
`market`可选string \| null	Market pinned for the selected channel and node family.
`resultKind`可选AnalyzedRecordKind \| null	Record family pinned for the answer.
`nodeKind`可选NodeKind \| null	Node family pinned for a node answer.
`windowDays`可选integer \| null	Time window in days pinned for windowed metrics; refused when the cell cannot apply one.

RowPreview2

ELTA's preview of one kept row at the list's current revision.

`diff`必填ActionDiff
`outcome`必填ActionOutcome

RunEnding3

How a finished run ended, kept on its run state after the durable event is delivered.

`outcome`必填RunOutcome
`failureCode`可选RunFailureCode \| null
`step`可选RunStep \| null

RunFailureCode可选值 · 4

The finite reasons a run ended without success.

可选值: IN_FLIGHT_CALLWAIT_EXPIREDSETUP_INVALIDSTEP_ATTEMPTS_EXHAUSTED

RunOutcome可选值 · 3

The execution outcome of a run. The host owns settlement.

可选值: SUCCEEDEDFAILEDABANDONED

RunRead8

Where the run stands: the stepper, the step waiting for review, queued work, the grid's shape.

`positioning`必填PositioningRecord
`nextStep`必填RunStep \| null
`waitingAfter`必填RunStep \| null
`waitingUntil`必填string \| null
`queued`必填ChangeActionType[]
`ending`必填RunEnding \| null
`dimensions`必填DimensionRecord[]
`criteria`必填CriterionRecord[]

RunStep可选值 · 6

The six run steps, in order. Each of the first five can be reviewed by the caller.

可选值: SCOPESOURCEDIMENSIONSPLACEASSESSSCORE

SampleConfirmation5

SAMPLE_CONFIRMATION (1.6): the sample shown, the seller's verdict, and what to change.

`step`可选string	可选值: `SAMPLE_CONFIRMATION` 默认: `"SAMPLE_CONFIRMATION"`
`shownPostKeys`必填string[]
`verdict`必填SampleVerdict
`feedback`可选string \| null
`revisePostKeys`可选string[]	默认: `[]`

SampleRelevanceAnswer2

A fragment of the delegated sample-relevance decision.

`decisionType`可选string	可选值: `SAMPLE_RELEVANCE` 默认: `"SAMPLE_RELEVANCE"`
`verdicts`必填SampleRelevanceVerdict[]	One verdict per judged item.

SampleRelevanceItem6

ONE frozen product projection: a labelled baseline or a candidate.

`itemKey`必填string	Stable candidate identity.
`asin`必填string	Display ASIN.
`title`可选string \| null	Display title.
`brand`可选string \| null	Display brand.
`imageUrl`可选string \| null	Display image URL.
`price`可选MinorUnitMoney \| null	Observed selling price.

SampleRelevanceVerdict5

ONE verdict on whether a candidate belongs to the analysed product.

`itemKey`必填string	Judged candidate identity.
`similarity`必填ProductSimilarType	Matcher similarity level.
`isBattery`可选boolean \| null	Whether the candidate contains a battery.
`isApparel`可选boolean \| null	Whether the candidate is apparel.
`reason`可选string	Short justification. 默认: `""`

SampleVerdict可选值 · 2

The seller's reaction to the sample the agent showed (1.6).

可选值: APPROVEDREVISE

SaveCriterion3

Create or replace one criterion; its results are judged only when asked (ASSESS).

`type`可选string	可选值: `SAVE_CRITERION` 默认: `"SAVE_CRITERION"`
`actionKey`必填string
`criterion`必填CriterionRecord

SaveDimension3

Create or replace one dimension with its ordered options (rename, reorder, drop in one save).

`type`可选string	可选值: `SAVE_DIMENSION` 默认: `"SAVE_DIMENSION"`
`actionKey`必填string
`dimension`必填DimensionRecord

SaveView5

Create or replace one saved view in the viewer's own viewport.

`type`可选string	可选值: `SAVE_VIEW` 默认: `"SAVE_VIEW"`
`actionKey`必填string
`viewer`必填ViewerRef
`expectedRevision`必填integer
`view`必填ViewDefinition

ScenarioRole可选值 · 4

Role of one coherent economic scenario inside a profit envelope.

可选值: ROBUSTEXPECTEDPOSSIBLETIER_PROBE

SceneCueBinding1

A plan column whose non-empty cell queues one paid GenerateScene(replaces=…) on that row's image.

binding可选string

可选值: SCENE_CUE

默认: "SCENE_CUE"

Score2

Recompute the scorecard from the cells as they are now (after edits, if the caller wants).

`type`可选string	可选值: `SCORE` 默认: `"SCORE"`
`actionKey`必填string

ScreeningEnforcement可选值 · 2

Whether a cited screening finding blocks proposing or is shown as guidance.

可选值: BLOCKHINT

ScreeningFinding5

One finding: why, where, matched text, rule and copied enforcement.

`reason`必填ScreeningRefusal
`pointer`必填string
`matchedText`必填string
`rule`必填ScreeningRule
`enforcement`必填ScreeningEnforcement

ScreeningRefusal可选值 · 4

Why a text leaf is blocked; each value has its own user-facing explanation key.

可选值: SENSITIVE_CATEGORYFORBIDDEN_TERMKNOWN_NON_OWNER_BRANDDISALLOWED_CHARACTER

ScreeningResult3

Cited findings under one deployed rule bundle and one frozen brand corpus.

`policyBundleVersion`必填string
`brandCorpus`必填BrandCorpusRef
`findings`必填ScreeningFinding[]

ScreeningRule3

One checked-in rule, its citation and whether its findings block.

`ruleId`必填string
`citation`必填PolicyCitation
`enforcement`必填ScreeningEnforcement

Search3

A direct target query or a shortest typed path from a source object.

`fromObject`必填FromObject \| null	Source object the path starts from; null runs one query for the target kind from search alone.
`search`必填SearchObject	The requested target kind, exact identities and typed predicates.
`sourceMode`可选SourceMode	Which source the read executes against: live sources, published analyzed rows, or analyzed with a live fallback. 默认: `"LIVE"`

SearchAnswer2

A public decoded single-subject answer.

`object`必填string	Public object discriminator. 可选值: `answer`
`answer`必填string	Decoded answer text for the caller.

SearchClarify4

A public clarification request.

`object`必填string	Public object discriminator. 可选值: `clarify`
`askUser`必填string	Question the caller must answer.
`choices`必填string[]	Allowed clarification choices.
`queryKey`必填string	Stored partial-query key being resumed.

SearchItem8

One public result item of the text-routed search page.

`object`必填string	Public object discriminator. 可选值: `record`
`recordKind`必填AnalyzedRecordKind	Record family of the item.
`recordKey`必填string	Stable record key.
`channel`必填Channel \| null	Source channel, when applicable.
`label`可选string \| null	Readable display label, when known.
`fields`必填object	Authorized dynamic scalar values for the record.
`evidence`必填MatchedFact[]	Evidence explaining the matched query clauses.
`relations`可选RelationRef[]	Observed relationships to other served nodes; at most 16. 默认: `[]`

SearchObject21

The requested target kind, exact identities and typed target predicates.

`kind`必填NodeKind	Node kind requested as the target of the search.
`targetIds`可选NodeRef[] \| null	Explicit target identities to restrict the result to; null means no explicit selection.
`clauses`可选TextClause[] \| BrandClause[] \| CategoryClause[] \| MetricClause[] \| PriceClause[] \| DateClause[] \| ContactClause[] \| RelationClause[]	Predicates ANDed over the target; CONTACT and RELATION are tested by the stored read only, on kinds whose read bindings declare them, and cannot appear in any_of. 默认: `[]`
`anyOf`可选TextClause[][] \| BrandClause[][] \| CategoryClause[][] \| MetricClause[][] \| PriceClause[][] \| DateClause[][]	Groups whose member predicates are ORed together; the groups themselves are ANDed. 默认: `[]`
`channel`可选Channel \| null	Channel to search; null searches stored rows across channels, and a live search needs a channel.
`peers`可选PeerIntent \| null	Same-kind peer meaning (competitors/lookalikes); valid only when the source and target kinds match.
`evidenceBases`可选EvidenceBasis[] \| null	Keep only hits whose path basis (the weakest hop on the strongest path from from_object) is in this nonempty, unique set; omission/null keeps every basis. Search-only; requires from_object. RECORDED includes recorded promotion links. NodeHit.promoted separately indicates a recorded promotional link or explicit paid sponsorship; when the hit's claim about the matched entity carries a stance, paid sponsorship counts only if that claim recommends the entity as the item's main subject. It does not determine the path basis. MENTIONED: the content's text names it, with no platform link. SIMILAR: resemblance only. This selector never re-admits stored SIMILAR promotion rows excluded by platform rules.
`observedOnly`可选boolean	Search observed values only; false searches the effective value. 默认: `false`
`market`可选string \| null	Market the search runs in; null uses the searcher's default.
`sort`可选Sort \| null	Ordering of the returned target rows.
`require`可选string[]	Fields that every returned record must carry. 默认: `[]`
`conceptKind`可选ConceptKind \| null	Concept kind filter when the target kind is CONCEPT.
`preset`可选MotifSection \| null	Named motif section preset; valid only for a MOTIF target read in ANALYZED mode.
`textFrom`可选string \| null	Which source fact becomes the target's search text; null keeps the standard builder.
`dateWindow`可选DateWindow \| null	Inclusive calendar span for a KEYWORD or CONTENT target.
`motifWindow`可选MotifWindow \| null	Motif comparison window: the selected days and the equally long window before them.
`livePage`可选integer \| null	LIVE-only page number carried to the DIC query; null uses the DIC default. A stored read refuses it with UNSUPPORTED_QUESTION.
`buyBoxFulfilledByMarketplace`可选boolean \| null	PRODUCT LIVE only: carried to the DIC ProductQuery field of the same name; a stored read refuses it with UNSUPPORTED_QUESTION.
`oneVariantPerParent`可选boolean \| null	PRODUCT LIVE only: collapse to one variant per parent; null keeps the DIC default (every variant). A stored read refuses it with UNSUPPORTED_QUESTION.
`acquisition`可选AcquisitionMode \| null	Acquisition path copied to DIC; null or LIVE is the normal read. PUBLIC_PAGE is allowed only on a discovery refresh exact-id re-fetch, never serving. SNAPSHOT is a dataset opt-in allowed only on a non-seeded LIVE discovery root.
`limit`可选integer	Maximum number of target rows returned. 默认: `20`

SearchPage9

A public page of text-routed search items and its opaque cursor.

`coveragePartial`可选boolean	Coverage notes were counted over a candidate batch or suppressed, so whole-cell counts are unknown; also set when the page's rows, including a successful empty page, cover only a frozen lexical candidate set, leaving records with no PHRASE hit or ranked beyond the retained window unreachable. 默认: `false`
`object`必填string	Public object discriminator. 可选值: `search_page`
`resultKind`必填AnalyzedRecordKind	Family shared by all page items.
`items`必填SearchItem[]	Result items in page order.
`coverage`必填CoverageNote[]	Disclosed coverage gaps.
`windowEnd`必填string	Resolved window end for this page.
`cursor`必填string \| null	Opaque signed token for the next page.
`unapplied`可选string[]	Verbatim question substrings the router could not apply; at most 8. 默认: `[]`
`emptyCause`可选GapKind \| null	Why this page returned no items; null when it carries items.

SearchPending3

A public search whose source has not settled yet.

`object`必填string	Public object discriminator. 可选值: `search_pending`
`detail`必填string	Safe explanation: results are still being collected; repeat the same search shortly.
`retryAfterSeconds`必填integer	Seconds after which the caller may repeat the same search.

SearchPlacement4

One typed display placement of a RANKED_FOR relationship.

`placement`必填SearchPlacementType
`rank`可选integer \| null
`page`可选integer \| null
`pageRank`可选integer \| null

SearchPlacementType可选值 · 7

Name one documented Amazon search-result placement in plain channel terms.

可选值: ORGANICSPONSORED_PRODUCTSAMAZON_CHOICESPONSORED_BRANDSSPONSORED_BRANDS_VIDEOOTHER_ORGANICOTHER_SPONSORED

SearchRefused6

A typed public refusal with honest, topic-free next steps.

`object`必填string	Public object discriminator. 可选值: `refused`
`reason`必填string	Stable public refusal reason. 可选值: `UNSUPPORTED_QUESTIONDATA_CHANGEDINVALID_CURSORNOT_AVAILABLE`
`detail`必填string	Safe explanation of the refusal.
`refusal`必填Refusal	Typed refusal code, field and DP-worded detail.
`suggestions`可选CreatorHandleSuggestion[] \| TopByMetricSuggestion[]	Supported next steps that do not reuse an unapplied topic. 默认: `[]`
`failureRef`可选FailureRef \| null	Public request-ledger id this refusal was recorded as.

SearchRequest7

One question or structured search with an optional per-call row ceiling.

`maxRows`可选integer \| null	Optional row ceiling for this call; the smaller of this and the normal page size is returned. Omission preserves the normal page size.
`answerLanguage`可选AnswerLanguage	Language of seller-facing clarifications and refusals. 默认: `"EN"`
`question`可选string \| null	The natural-language question to answer.
`search`可选Search \| null	The typed structured search to execute.
`hints`可选RouteHints \| null	Optional predicates pinned into the stored plan.
`clarification`可选ClarificationAnswer \| null	The stored clarification choice being resumed.
`fields`可选string[] \| null	Authorized display-field whitelist; null means all authorized fields.

SeedCallBound4

Declare a finite physical-call ceiling for one exact seeded route.

`selector`必填string	可选值: `idshandle_selectorsdomain_selectorsproduct_refscreator_refsstore_refskeyword_refscompetitor_refsparent_refsstore_domainstextcategorysort`
`subjectKind`必填ObjectKind
`callsPerSubjectPage`必填integer
`maxPages`必填integer

SetBackground3

Set an image's background colour (literal or kit ref); on a VARIANT it is a BACKGROUND override.

`action`可选string	可选值: `SET_BACKGROUND` 默认: `"SET_BACKGROUND"`
`designId`必填string
`color`必填Color \| BrandColorRef

SetBoardTitle2

Rename the board through the same revisioned edit batch as every other change.

`action`可选string	可选值: `SET_BOARD_TITLE` 默认: `"SET_BOARD_TITLE"`
`title`必填string

SetBox4

Move, resize or rotate one layer; on a group, its children move and scale so their bounds become box.

`action`可选string	可选值: `SET_BOX` 默认: `"SET_BOX"`
`designId`必填string
`layerId`必填string
`box`必填Box

SetDailyBudgetValue2

The suggested daily budget of one Sponsored Products campaign.

`kind`可选string	可选值: `daily_budget` 默认: `"daily_budget"`
`dailyBudget`必填number \| string

SetImageTransform6

Set an image layer's flips and crop together (all stated, like SetLayerFlags); free.

`action`可选string	可选值: `SET_IMAGE_TRANSFORM` 默认: `"SET_IMAGE_TRANSFORM"`
`objectId`必填string
`layerId`必填string
`flipX`必填boolean
`flipY`必填boolean
`crop`必填Box \| null

SetLayerFlags8

Set a layer's name, opacity, blend, visibility and lock together (all stated, none optional).

`action`可选string	可选值: `SET_LAYER_FLAGS` 默认: `"SET_LAYER_FLAGS"`
`designId`必填string
`layerId`必填string
`name`必填string
`opacity`必填number
`blendMode`必填BlendMode
`visible`必填boolean
`locked`必填boolean

SetObjectFrame4

Rename and/or move any object on the board; allowed while AI-busy (a landing never reads position).

`action`可选string	可选值: `SET_OBJECT_FRAME` 默认: `"SET_OBJECT_FRAME"`
`objectId`必填string
`name`可选string \| null
`position`可选BoardPoint \| null

SetObjectLock3

Lock or unlock one object against agent edits; sole in its batch, USER only, writes only the lock map.

`action`可选string	可选值: `SET_OBJECT_LOCK` 默认: `"SET_OBJECT_LOCK"`
`objectId`必填string
`locked`必填boolean

SetPlacements4

Put groups into options of one dimension by hand (None takes a group out).

`type`可选string	可选值: `SET_PLACEMENTS` 默认: `"SET_PLACEMENTS"`
`actionKey`必填string
`dimensionKey`必填string
`placements`必填object

SetPlan5

Edit a plan: replace its columns, upsert rows by id, delete rows (merges rev 1's two plan actions).

`action`可选string	可选值: `SET_PLAN` 默认: `"SET_PLAN"`
`planId`必填string
`columns`可选PlanColumn[] \| null
`upsertRows`可选PlanRow[]	默认: `[]`
`deletedRowIds`可选string[]	默认: `[]`

SetResults4

Write cells' results of one assessment or criterion by hand (the ASSESS review's answer).

`type`可选string	可选值: `SET_RESULTS` 默认: `"SET_RESULTS"`
`actionKey`必填string
`assessment`必填string
`results`必填object

SetReview3

Change who decides the named steps; takes effect at the next step that ends.

`type`可选string	可选值: `SET_REVIEW` 默认: `"SET_REVIEW"`
`actionKey`必填string
`review`必填object

SetSettings4

Set values on one section, or on one of its blocks when block_key is given.

`action`可选string	可选值: `SET_SETTINGS` 默认: `"SET_SETTINGS"`
`sectionKey`必填string
`blockKey`可选string \| null
`settings`必填object

SetSetup3

Replace the named setup values (the SCOPE review's answer, or a later correction).

`type`可选string	可选值: `SET_SETUP` 默认: `"SET_SETUP"`
`actionKey`必填string
`values`必填object

SetShadow4

Set or clear the drop shadow of any leaf layer (image, text or shape).

`action`可选string	可选值: `SET_SHADOW` 默认: `"SET_SHADOW"`
`designId`必填string
`layerId`必填string
`shadow`必填DropShadow \| null

SetShapeStyle6

Replace a shape layer's fill and stroke, and optionally its geometry (None keeps the current one).

`action`可选string	可选值: `SET_SHAPE_STYLE` 默认: `"SET_SHAPE_STYLE"`
`designId`必填string
`layerId`必填string
`fill`必填Color \| BrandColorRef \| LinearGradient \| RadialGradient \| null
`stroke`必填Stroke \| null
`geometry`可选RectGeometry \| EllipseGeometry \| LineGeometry \| PolygonGeometry \| PathGeometry \| null

SetStatus7

Where a set is: head revision and its commit time, paid steps, last refusal, AI pause, non-READY objects.

`setId`必填string
`headRevision`必填integer
`headCommittedAt`可选string \| null
`steps`可选PaidStepView[]	默认: `[]`
`lastRefusal`可选EditRefusal \| null
`aiPausedUntil`可选string \| null
`objects`可选ObjectStatus[]	默认: `[]`

SetText4

Replace a text layer's text.

`action`可选string	可选值: `SET_TEXT` 默认: `"SET_TEXT"`
`designId`必填string
`layerId`必填string
`text`必填string

SetTextStyle4

Replace a text layer's whole style (font, weight, size, colour, alignment).

`action`可选string	可选值: `SET_TEXT_STYLE` 默认: `"SET_TEXT_STYLE"`
`designId`必填string
`layerId`必填string
`style`必填TextStyle

SetVariantRecipe3

Replace a variant's recipe: the one writer of its preset, size, fit, colour map and plan row.

`action`可选string	可选值: `SET_VARIANT_RECIPE` 默认: `"SET_VARIANT_RECIPE"`
`objectId`必填string
`recipe`必填VariantRecipe

SetupField8

One input a positioning of this plugin needs before sourcing.

`key`必填string
`label`必填LocalizedText
`help`必填LocalizedText
`kind`必填SetupFieldKind
`options`可选SetupOption[]	默认: `[]`
`required`可选boolean	默认: `true`
`maxItems`可选integer \| null
`minimum`可选number \| string \| null

SetupFieldKind可选值 · 5

How one setup input is entered in the create form and filled by the scope model.

可选值: TEXTTEXT_LISTCHOICEMULTI_CHOICENUMBER

SetupOption2

One allowed value of a CHOICE field.

`value`必填string
`label`必填LocalizedText

ShadowField2

Override value: a leaf layer's drop shadow (None = no shadow).

`field`可选string	可选值: `SHADOW` 默认: `"SHADOW"`
`shadow`必填DropShadow \| null

ShapeLayer12

Free vector composition: panels, bands, badges, outlines and icons.

`layerId`必填string
`name`必填string
`opacity`可选number	默认: `1`
`blendMode`可选BlendMode	默认: `"NORMAL"`
`visible`可选boolean	默认: `true`
`locked`可选boolean	默认: `false`
`box`必填Box
`shadow`可选DropShadow \| null
`kind`可选string	可选值: `SHAPE` 默认: `"SHAPE"`
`geometry`必填RectGeometry \| EllipseGeometry \| LineGeometry \| PolygonGeometry \| PathGeometry
`fill`可选Color \| BrandColorRef \| LinearGradient \| RadialGradient \| null
`stroke`可选Stroke \| null

ShippingMode可选值 · 3

First-leg transport mode from the manufacturer to the marketplace.

可选值: FREIGHTAIRRAIL

ShippingProfile5

Canonical shipping-rate inputs for legacy float weight formulas.

`exchangeRates`必填ExchangeRateInUsd[]
`freightPerKg`必填MinorUnitMoney
`airPerKg`必填MinorUnitMoney
`railPerKg`可选MinorUnitMoney \| null
`cubicCmBreakpoint`可选integer	默认: `6000`

ShopifyRemoteImage2

An HTTPS image source Shopify must ingest through fileCreate before content write.

`url`必填string
`alt_text`可选string	默认: `""`

SizingDetail18

Typed replacement for the legacy === METADATA === sizing prose.

`sizeTier`必填string
`longestSideInches`必填number
`medianSideInches`必填number
`shortestSideInches`必填number
`longestSideCm`必填number
`medianSideCm`必填number
`shortestSideCm`必填number
`weightLb`必填number
`weightKg`必填number
`dimensionalWeightLb`可选number \| null
`dimensionalWeightKg`可选number \| null
`shippingWeightLb`可选number \| null
`shippingWeightKg`可选number \| null
`volumeCubicMeter`必填number
`girth`必填number
`girthUnit`必填string	可选值: `inchcm`
`feeCategory`必填string
`source`必填EstimateSource

SlotFinding4

One rule checked on one design: passed or not, with the measured value when numeric.

`designId`必填string
`rule`必填WhiteBackgroundRule \| MinLongestSideRule \| MaxLongestSideRule \| ProductFillRule \| NoTextRule \| NoGraphicsRule \| NoEdgeCropRule \| NoBadgeClaimsRule \| LayerClippedRule
`passed`必填boolean
`measured`可选number \| null

SocialTextTrack8

Retain one bounded transcript or caption with truthful truncation facts.

`language`可选string \| null
`kind`必填SocialTextTrackKind
`text`可选string \| null
`capturedAt`必填string
`provenance`必填Provenance
`truncated`可选boolean	默认: `false`
`omitted`可选boolean	默认: `false`
`originalLength`可选integer \| null

SocialTextTrackKind可选值 · 2

Distinguish transcript and caption text without provider-specific kinds.

可选值: TRANSCRIPTCAPTION

Sort5

Request ordering by one typed metric, or by one launch instant.

`metric`可选MetricKind \| null
`field`可选string \| null
`direction`可选string	可选值: `DESCASC` 默认: `"DESC"`
`window`可选RankingWindow \| null
`change`可选boolean	默认: `false`

Source13

One thing an owner binds: a provider grant that reaches one or more accounts.

`key`必填string	Connectable catalog source identifier.
`title`必填StoreLocalizedText	Display name of this source, in both languages.
`connect`必填ConnectStyle[]	Ways this deployment offers to bind.
`credentials`必填Credential[]	Access fields used by this source.
`regions`可选ProviderRegion[]	Sales regions the owner picks from before consent; empty means no region step. 默认: `[]`
`available`可选boolean	False when this deployment cannot connect the source yet. 默认: `true`
`consentLifetimeDays`可选integer \| null	Provider-forced consent lifetime in days, when declared.
`accountAttributes`可选Attribute[]	Metadata attributes discovery reports for each account. 默认: `[]`
`datasets`可选Dataset[]	Datasets captured and retained. 默认: `[]`
`lookups`可选Lookup[]	Reads answered live without storing their results. 默认: `[]`
`actions`可选ProviderWriteActionType[]	Writes applied only after approval. 默认: `[]`
`revokeReach`可选RevokeReach	Whether removal asks the provider to revoke access; LOCAL destroys only the stored credentials. 默认: `"LOCAL"`
`revokeUrl`可选string \| null	The provider page where the owner withdraws this access; https only.

SourceDescriptionKind可选值 · 10

DP-owned: WHICH descriptive field of a source a string came from.

可选值: SEARCH_TERMTAGHASHTAGTITLEBRANDNAMEHANDLECATEGORYCONCEPTMOTIF

SourceMode可选值 · 3

WHICH READ SOURCE one search step executes against.

可选值: LIVEANALYZEDANALYZED_THEN_LIVE

SourceReference5

A link that supports an item or an assessment, with the source context people saw.

`url`必填string
`title`可选string \| null
`snippet`可选string \| null
`publisher`可选string \| null
`publishedAt`可选string \| null

SourceSubject3

Identify one source object by channel, content kind, and exact external ID.

`channel`必填Channel
`kind`必填ObjectKind
`externalId`必填string

SourcedItem7

One item a plugin found: identity, facts and what models see.

`key`必填string
`name`必填string
`groupKey`可选string \| null
`main`可选boolean	默认: `false`
`facts`可选object
`prompt`必填ItemPrompt
`references`可选SourceReference[]	默认: `[]`

SpanEvidence3

The transcript span or caption an element cites.

`kind`必填string	Citation shape: TRANSCRIPT for a timed span, CAPTION for a whole caption. 可选值: `TRANSCRIPTCAPTION`
`startMs`可选integer \| null	Start offset of the cited transcript span in milliseconds; null for a CAPTION.
`endMs`可选integer \| null	End offset of the cited transcript span in milliseconds; null for a CAPTION.

StageGuide2

The kind's instruction to the agent for the current stage, returned on every read.

`stage`必填ChangeListStage
`instruction`必填string

StagedProposal3

The exact create batch staged on an artifect snapshot BEFORE propose is called.

`replayKey`必填string
`batch`必填ActionBatch
`validUntil`必填string

StalePart2

One out-of-date part of an image; the editor dims it with a "Refresh · N 次请求" chip.

`reason`必填StaleReason
`layerId`可选string \| null

StaleReason可选值 · 1

Why part of a variant is out of date (free parts never go stale: they resolve live).

可选值: SOURCE_CHANGED

StandingAdjust2

MIRROR wire ArtifectStandingAdjust: pause, resume or run a standing artifect now.

`adjustmentType`可选string	可选值: `STANDING` 默认: `"STANDING"`
`command`必填StandingControl

StandingControl可选值 · 3

The core-owned standing commands (MIRROR wire ArtifectStandingAdjust.command).

可选值: PAUSERESUMERUN_NOW

StandingPauseBy可选值 · 3

Who paused a standing run (StandingFacts.paused_by); core sets it on every move to PAUSED.

可选值: CALLERGATEKIND

StandingState可选值 · 4

Where one standing artifect is (MIRROR wire ArtifectStandingState); core owns the moves.

可选值: SETTING_UPACTIVEPAUSEDSTOPPED

StandoutItem13

ONE already-built listing the agent may choose as a standout.

`itemKey`必填string	Stable listing identity.
`asin`必填string	Display ASIN.
`title`可选string \| null	Display title.
`brand`可选string \| null	Display brand.
`imageUrl`可选string \| null	Display image URL.
`price`可选MinorUnitMoney \| null	Observed selling price.
`latestMonthlySold`可选integer \| null	The representative member's latest observed monthly sold units from the LISTING_BUILD cohort. This is ONE member's signal, NOT a family total. None means not measured.
`ratingInt`可选integer \| null	Star rating in tenths (0 through 50); the same name and meaning as ReportAsinDisplayFact.rating_int.
`reviewCount`可选integer \| null	Retained review count; the same name and meaning as ReportAsinDisplayFact.review_count.
`memberCount`可选integer \| null	Members the listing summary retained.
`familyEntryAgeMonths`可选integer \| null	Family entry age in months; a FAMILY age, not the member's.
`expectedProfit`可选MinorUnitMoney \| null	LISTING_ECONOMICS expected-scenario profit; None when the listing's profit inputs are unresolved.
`margin`可选ReportRatioRange \| null	LISTING_ECONOMICS margin range, verbatim.

StandoutSelectionAnswer4

The agent's standout choice for a completed analysis.

`decisionType`可选string	可选值: `STANDOUT_SELECTION` 默认: `"STANDOUT_SELECTION"`
`picks`必填ReportStandoutPick[]	Chosen standouts, in display order.
`market`可选ReportStandoutMarketTraits \| null	Optional old-report market traits; omit to hide the market-traits part.
`commonItemKeys`可选string[]	Offered itemKeys of typical, NOT standout, listings; omit to hide the common-products part. 默认: `[]`

StdMoneyAmount1

Store one immutable signed-Int64 monetary minor-unit amount.

value必填integer

StorageLineDetail4

Per-month composition of one aggregated storage breakdown line.

`months`必填integer[]
`volumeCubic`必填number
`cubicUnit`必填string	可选值: `ftm`
`perMonth`必填MonthlyStorageFee[]

Store11

Represent a selling entity with a stable channel ID and alias fields.

`kind`可选string	可选值: `STORE` 默认: `"STORE"`
`channel`必填Channel
`externalId`必填string
`name`可选string \| null
`description`可选string \| null
`domain`可选string \| null
`market`可选string \| null
`publishedAt`可选string \| null
`metrics`可选MetricObservation[]	默认: `[]`
`observedAt`必填string
`provenance`必填Provenance

StoreCapabilities5

What the installed sources can do right now for one store: live reads, writes and captures.

`object`可选string	Document type: store capabilities. 可选值: `store_capabilities` 默认: `"store_capabilities"`
`storeId`必填string	Store whose current abilities this document describes.
`lookups`必填CapabilityRow[]	Installed live reads: one row per (key, account).
`actions`必填CapabilityRow[]	Installed provider writes: one row per (key, account).
`datasets`必填CapabilityRow[]	Installed captured datasets: one row per (key, account).

StoreOwner可选值 · 2

Which service's least-privilege byte API serves this ref (fixes the 'same ref type, unknown store' hole).

可选值: DATA_INFRAPLATFORM

StoreRecord12

One owner's store spanning installed sources, with lifecycle state and stored rows.

`object`可选string	Document type: store record. 可选值: `store_record` 默认: `"store_record"`
`storeId`必填string	Store identifier within the asserted owner scope.
`title`必填string	Owner's display name for the store.
`region`必填ProviderRegion \| null	Sales region chosen before consent; null while the store has no region.
`status`必填StoreStatus	Whether this store may sync.
`pauseReason`可选PauseReason \| null	Why sync is paused; null when active.
`connections`可选ConnectionRecord[]	Connectors bound to this store; empty means connection is unfinished. 默认: `[]`
`createdAt`必填string	When the store was created.
`lastSyncedAt`可选string \| null	Display-only aggregate: the oldest last_synced_at among active connections, excluding blocked and parked lanes; null while any active connection has never synced. ConnectionRecord's last_synced_at and synced_through are authoritative.
`storedRows`可选integer	Current stored fact rows across the store's connectors, never a per-sync count. 默认: `0`
`writePolicy`可选WritePolicy	Owner-controlled provider-write families.
`removing`可选boolean	A removal started and has not finished. The record is kept only so the same DELETE can finish it: capture, binding and lifecycle commands refuse it. False for every normal record. 默认: `false`

StoreStatus可选值 · 2

Whether capture may run for the store; paused reads remain available.

可选值: ACTIVEPAUSED

StoresResponse2

The stores belonging to the asserted owner, including unfinished stores.

`object`可选string	Document type: stores response. 可选值: `stores_response` 默认: `"stores_response"`
`stores`必填StoreRecord[]	Stores belonging to the asserted owner.

Stroke2

An outline colour and width.

`color`必填Color \| BrandColorRef
`width`必填number

StrokeField2

Override value: a shape layer's stroke (None = no stroke).

`field`可选string	可选值: `STROKE` 默认: `"STROKE"`
`stroke`必填Stroke \| null

StyleExample5

One real article the agent found as a model for one tone (1.3); dated on/after the Setting.

`toneKey`必填string
`articleUrl`必填string
`title`必填string
`publishedOn`必填string
`styleNotes`必填string

StyleExamples2

STYLE_EXAMPLES (1.3): at least one example for every tone the plan declares.

`step`可选string	可选值: `STYLE_EXAMPLES` 默认: `"STYLE_EXAMPLES"`
`examples`必填StyleExample[]

SuggestedKeywordEvidence1

A term no server-read report row matched: a suggestion, explicitly not a measurement.

kind可选string

可选值: SUGGESTED

默认: "SUGGESTED"

SuggestedPurchasingCost5

User suggestion calibrated against one marketplace benchmark product.

`asin`必填string
`suggestedPurchasingCost`必填MinorUnitMoney
`benchmarkSellingPrice`必填MinorUnitMoney
`amazonMarketplace`必填AmazonMarketplace
`suggestedPurchasingCostUpper`可选MinorUnitMoney \| null	Upper bound when the seller's cost is a range; None for a single value. Same currency as suggested_purchasing_cost, never below it.

SumCombine1

Range value = the sum of the days' values.

kind可选string

Range combination: sum of daily values.

可选值: sum

默认: "sum"

TaskExceptionType可选值 · 7

Closed persisted task-failure classifications shared by maintained lines.

可选值: UNKNOWNPAID_ATTEMPT_UNKNOWNFAILED_TO_STARTNO_SUFFICIENT_DATATIMEOUTINPUT_EXPIREDCANCELLED

TaskStage可选值 · 5

可选值: PENDINGPROCESSINGWAITING_FOR_INPUTSUCCESSFAILURE

TextAlign可选值 · 3

Horizontal alignment inside the text box.

可选值: LEFTCENTERRIGHT

TextClause4

Search one named text field or request broad text discovery.

`kind`可选string	可选值: `TEXT` 默认: `"TEXT"`
`field`可选string \| null
`value`必填string
`op`可选string	可选值: `SEARCHPHRASE` 默认: `"SEARCH"`

TextField2

Override value: a text layer's text.

`field`可选string	可选值: `TEXT` 默认: `"TEXT"`
`text`必填string

TextFill2

Fill a HEADLINE/BODY_TEXT placeholder.

`placeholder`必填string	可选值: `bodycallout_1callout_2callout_3headlineproduct_photo`
`text`必填string

TextHunk3

One contiguous text edit with its zero-based old/new origins and line operations.

`oldStart`必填integer	Zero-based old-file hunk start.
`newStart`必填integer	Zero-based new-file hunk start.
`lines`必填TextLine[]	Changed and context lines.

TextLayer12

Text wrapped inside its box width (line breaks computed by the one keble-core scene mapper).

`layerId`必填string
`name`必填string
`opacity`可选number	默认: `1`
`blendMode`可选BlendMode	默认: `"NORMAL"`
`visible`可选boolean	默认: `true`
`locked`可选boolean	默认: `false`
`box`必填Box
`shadow`可选DropShadow \| null
`kind`可选string	可选值: `TEXT` 默认: `"TEXT"`
`text`必填string
`style`必填TextStyle
`placeholder`可选string \| null

TextLayerBinding2

A plan column whose cell text replaces one TEXT layer of the plan's source image.

`binding`可选string	可选值: `TEXT_LAYER` 默认: `"TEXT_LAYER"`
`layerId`必填string

TextLine4

One raw source line with one-based before/after coordinates.

`operation`必填TextLineOperation	Context, inserted or deleted line.
`text`必填string	Raw text of the line.
`oldLine`可选integer \| null	One-based old-file line number.
`newLine`可选integer \| null	One-based new-file line number.

TextLineOperation可选值 · 3

One unchanged, inserted or deleted source line in a text diff.

可选值: CONTEXTINSERTDELETE

TextStyle7

How a text layer is set; font is a reference (stored as its key).

`font`必填string \| BrandFontRef
`weight`可选FontWeight	默认: `"REGULAR"`
`size`必填number
`color`必填Color \| BrandColorRef
`align`可选TextAlign	默认: `"LEFT"`
`lineHeight`可选number	默认: `1.2`
`letterSpacing`可选number	默认: `0`

ThemeBlockInstance3

One block inside one Keble section: its stable key, its kind and its setting values.

`blockKey`必填string
`kind`必填KebleBlockKind
`settings`可选object

ThemeChangeSet6

Removed in the first theme release after SEO and GEO migrate.

`changeSetId`必填string
`draft`必填ThemeChangeSetDraft
`bases`可选ThemeFileBase[]	默认: `[]`
`preview`可选ThemePreviewCopy \| null
`proposals`可选ThemeProposalLink[]	默认: `[]`
`createdAt`必填string

ThemeChangeSetDraft3

Removed in the first theme release after SEO and GEO migrate.

`title`必填string
`edits`必填ThemeFileEdit[]
`newPage`可选NewThemePage \| null

ThemeCreateLedger9

Removed in the first theme release after SEO and GEO migrate.

`artifectRefId`必填string
`owner`必填string
`replayKey`必填string
`storeId`必填string
`account`必填AccountRef
`targetThemeId`必填string
`changeSets`必填ThemeChangeSet[]
`revision`必填integer
`createdAt`必填string

ThemeDocument1

The whole Keble document of one run: its pages, each placing Keble sections on one template.

pages可选ThemePage[]

默认: []

ThemeDocumentCreateRequest6

The document-run create input: store, optional target, title, author and first actions.

`replayKey`必填string
`storeId`必填string
`targetThemeId`可选string \| null
`title`必填string
`author`必填ThemeEditAuthor
`initialActions`可选AddPage[] \| AddSection[] \| MoveSection[] \| RemoveSection[] \| SetSettings[] \| AddBlock[] \| MoveBlock[] \| RemoveBlock[] \| ShopifyThemeRestoreRevision[]	默认: `[]`

ThemeDocumentOperation可选值 · 4

The document commands a caller may run next (the guide's vocabulary; the host maps its arms).

可选值: EDITUPDATE_PREVIEWPUBLISHDISCARD_PREVIEW

ThemeDocumentProposalLink4

A document run's proposal link: the 0.3.x link plus the revision the proposal compiled.

`purpose`必填ThemeProposalPurpose
`proposalId`必填string
`inboxItemId`可选string \| null	The backend To do approval item this proposal was filed as. None means a link recorded before keble-shopify-theme 0.3.0, which kept no inbox id: such links exist only on keble-test, expire naturally, and are never looked up by proposal id.
`documentRevision`可选integer \| null

ThemeDocumentProposalStateRead4

The live inbox state of one document-run proposal link, read by the theme host on every read.

`purpose`必填ThemeProposalPurpose
`proposalId`必填string
`documentRevision`可选integer \| null
`approval`必填ApprovalState \| null

ThemeDocumentSnapshot6

The owner-fenced document-run snapshot: head, head document, guide, publish summary, link.

`runKind`可选string	可选值: `DOCUMENT` 默认: `"DOCUMENT"`
`head`必填ThemeRunHead
`document`必填ThemeDocument
`guide`必填ThemeStageGuide
`publishSummary`可选ThemePublishSummary \| null
`previewLink`可选string \| null

ThemeEditAuthor可选值 · 2

Who submitted an edit: the chat agent or the person in the editor (revision provenance).

可选值: AGENTUSER

ThemeEditReceipt2

One recorded edit replay: its key and the revision it committed.

`replayKey`必填string
`revision`必填integer

ThemeFileBase3

One theme file's stamped base: its filename and the checksum ELTA's drift law compares.

`filename`必填string
`checksum_md5`必填string
`body`可选null

ThemeFileEdit2

Removed in the first theme release after SEO and GEO migrate.

`filename`必填string
`after`必填string

ThemeFrameSource可选值 · 2

Which theme a page frame renders: the run's preview copy or its target (live vs draft).

可选值: PREVIEW_COPYTARGET

ThemePage4

One page of the document: the template it places on, its preview path, and its sections.

`template`必填ThemeTemplateRef
`previewPath`必填string
`newPage`可选NewKeblePage \| null
`sections`可选ThemePlacedSection[]	默认: `[]`

ThemePageChange3

One changed page of a publish summary: the page's own change and/or its changed Keble sections.

`page`必填ThemeTemplateRef
`change`可选ThemeSectionChangeKind \| null
`sections`可选ThemeSectionChange[]	默认: `[]`

ThemePlacedSection2

One Keble section placed on a page: the section plus its anchor in the template's order.

`section`必填ThemeSectionInstance
`after`可选string \| null

ThemePreviewCopy3

Removed in the first theme release after SEO and GEO migrate.

`previewThemeId`必填string
`previewLink`可选string \| null
`createdAt`必填string

ThemeProposalLink3

One ELTA proposal this artifect opened: purpose, ELTA proposal id and its inbox item.

`purpose`必填ThemeProposalPurpose
`proposalId`必填string
`inboxItemId`可选string \| null	The backend To do approval item this proposal was filed as. None means a link recorded before keble-shopify-theme 0.3.0, which kept no inbox id: such links exist only on keble-test, expire naturally, and are never looked up by proposal id.

ThemeProposalPurpose可选值 · 5

Why one ELTA proposal was opened for a change set or a document revision.

可选值: PREVIEW_COPYPREVIEW_FILESACCEPTREVERTDISCARD

ThemeProposalStateRead4

The live inbox state of one theme proposal link, read by the keble-artifect theme host.

`changeSetId`必填string
`purpose`必填ThemeProposalPurpose
`proposalId`必填string
`approval`必填ApprovalState \| null

ThemePublishSummary5

What publishing would change, where, and whether the target moved since it was read.

`revision`必填integer
`publishedRevision`可选integer \| null
`targetTheme`必填ThemeRef
`pages`可选ThemePageChange[]	默认: `[]`
`drift`可选string[]	默认: `[]`

ThemeRef3

One theme as the store reports it now: its GID, display name and role.

`theme_id`必填string
`name`必填string
`role`必填ThemeRole

ThemeRevision7

One immutable committed revision of a document run: the document and the actions that made it.

`runKind`可选string	可选值: `DOCUMENT` 默认: `"DOCUMENT"`
`artifectRefId`必填string
`revision`必填integer
`document`必填ThemeDocument
`actions`可选AddPage[] \| AddSection[] \| MoveSection[] \| RemoveSection[] \| SetSettings[] \| AddBlock[] \| MoveBlock[] \| RemoveBlock[] \| ShopifyThemeRestoreRevision[]	默认: `[]`
`author`必填ThemeEditAuthor
`createdAt`必填string

ThemeRole可选值 · 6

A Shopify theme's role; only MAIN is the published, write-protected live theme.

可选值: ARCHIVEDDEMODEVELOPMENTLOCKEDMAINUNPUBLISHED

ThemeRunHead15

The small owner-scoped head row of one document run; revisions live beside it.

`runKind`可选string	可选值: `DOCUMENT` 默认: `"DOCUMENT"`
`artifectRefId`必填string
`owner`必填string
`replayKey`必填string
`createRequestHash`必填string
`storeId`必填string
`account`必填AccountRef
`targetThemeId`必填string
`title`必填string
`headRevision`必填integer
`editReceipts`可选ThemeEditReceipt[]	默认: `[]`
`preview`可选PreviewSession \| null
`proposals`可选ThemeDocumentProposalLink[]	默认: `[]`
`createdAt`必填string
`updatedAt`必填string

ThemeSectionChange3

One changed Keble section in a publish summary; the web names it from its kind's label.

`sectionKey`必填string
`kind`必填KebleSectionKind
`change`必填ThemeSectionChangeKind

ThemeSectionChangeKind可选值 · 3

How one Keble section differs between the published revision and the one being published.

可选值: NEWEDITEDREMOVED

ThemeSectionInstance4

One Keble section on a page: stable key (also its JSON-template entry id), kind, settings, blocks.

`sectionKey`必填string
`kind`必填KebleSectionKind
`settings`可选object
`blocks`可选ThemeBlockInstance[]	默认: `[]`

ThemeStage可选值 · 5

Where a document run stands, derived on every read and never stored.

可选值: DRAFTPREVIEWINGPREVIEW_READYPUBLISHINGPUBLISHED

ThemeStageGuide4

The stage and the commands allowed in it, computed by the runtime from one rule set.

`stage`必填ThemeStage
`allowed`可选ThemeDocumentOperation[]	默认: `[]`
`undoRevision`可选integer \| null
`liveIsUndo`可选boolean	默认: `false`

ThemeTemplateEntry4

One entry of a theme's JSON template as the runtime parsed it: id, section type and display name.

`entryId`必填string
`sectionType`必填string
`name`可选string \| null
`disabled`可选boolean	默认: `false`

ThemeTemplateOutline4

One template of the copy or the target with its merchant entries in order (this run's own excluded).

`template`必填ThemeTemplateRef
`entries`可选ThemeTemplateEntry[]	默认: `[]`
`order`可选string[]	默认: `[]`
`unresolvedSectionKeys`可选string[]	默认: `[]`

ThemeTemplateRef2

Typed identity of one JSON template: a template type plus an optional alternate suffix.

`templateType`必填ThemeTemplateType
`suffix`可选string \| null

ThemeTemplateType可选值 · 6

The JSON template types a Keble section may be placed on in v1 (templates/<type>[.<suffix>].json).

可选值: INDEXPRODUCTCOLLECTIONPAGEBLOGARTICLE

TimeAxis可选值 · 3

WHICH INSTANT a time window is measured on.

可选值: PUBLISHEDOBSERVEDLAUNCHED

TodoCreate3

Immutable original intent for an ordinary todo.

`kind`可选string	可选值: `TODO` 默认: `"TODO"`
`content`必填ItemContent
`key`可选string \| null

TodoItem11

Ordinary todo with immutable creation and mutable current content.

`id`必填string
`owner`必填OwnerRef
`current`必填ItemContent
`created_at`必填string
`revision`必填integer
`created_by`可选ActorRef \| null
`kind`可选string	可选值: `TODO` 默认: `"TODO"`
`object`可选string	可选值: `todo_item` 默认: `"todo_item"`
`creation`必填TodoCreate
`status`必填TodoStatus
`resolved_by`可选ActorRef \| null

TodoStatus可选值 · 3

An ordinary item remains stored and readable after completion.

可选值: OPENDONEWITHDRAWN

Tone可选值 · 2

The tint of a cell's conclusion.

可选值: OPPORTUNITYCAUTION

ToneSpec2

One tone the plan uses, defined once and referenced by key (round-3 m2).

`toneKey`必填string
`description`必填string

TopByMetricSuggestion5

An executable alternative over a declared numeric cell field.

`kind`可选string	Ranked-search suggestion discriminator. 可选值: `TOP_BY_METRIC` 默认: `"TOP_BY_METRIC"`
`nodeKind`必填NodeKind	Node family to rank.
`channel`必填Channel	Channel of the ranked nodes.
`metric`必填string	Declared numeric field code of the selected cell. 可选值: `review_countfollower_countview_count`
`windowDays`可选integer \| null	Applicable metric window in days; null for a current field value.

UnboundAction5

The account-free ELTA action accepted at every public change-list boundary.

`actionKey`必填string
`actionTypeKey`必填string
`target`必填EntityRef
`change`必填JsonValue
`baseVersion`可选string \| null

UngroupLayer3

Dissolve a group, keeping its children in place.

`action`可选string	可选值: `UNGROUP_LAYER` 默认: `"UNGROUP_LAYER"`
`designId`必填string
`groupId`必填string

Unit可选值 · 3

The physical unit of a measure or metric, so money, counts and ratios stay apart.

可选值: COUNTMONEYRATIO

UnlinkedMention6

ONE claim of a source item that no held record matched.

`stance`可选ClaimStance \| null	What the source item does toward the named entity in the cited claim; null when no claim is cited, the claim predates mention capture, or (on a relation) the edge's basis is SIMILAR (its claim names no such record).
`mainSubject`可选boolean \| null	Whether the cited claim names what the source item mainly promotes or is about; null when stance is null.
`emotion`可选ClaimEmotion \| null	How the source item feels about the named entity in the cited claim, STRONGLY_NEGATIVE to STRONGLY_POSITIVE; null when stance is null.
`phrase`可选string \| null	The source item's own words showing how it brings the named entity up, from the cited claim; null when not found verbatim, visual only, captured before mention capture, (on a relation) the basis is SIMILAR, or no claim is cited.
`relation`必填AnalyzedRelationKind	Relation the claim would draw if a record matched it; FEATURES_BRAND today.
`label`必填string	The named entity as the source item says it, from the claim.

UnresolvedBrandRef4

A kit ref whose entry (or kit) no longer exists; nothing is substituted silently (§4.3).

`layerId`必填string \| null
`field`必填LayerField
`kitId`必填string
`entryId`必填string

UpdateItems3

Change items' names, facts or relevance (the SOURCE review's answer, or any later edit).

`type`可选string	可选值: `UPDATE_ITEMS` 默认: `"UPDATE_ITEMS"`
`actionKey`必填string
`updates`必填ItemUpdate[]

ValueBasis可选值 · 2

Where one stored field value came from (PLAN §2.1, owner 1700 #).

可选值: OBSERVEDINFERRED

ValueStatus可选值 · 3

Whether a value exists; missing is never zero (existing ruling).

可选值: AVAILABLEUNAVAILABLEMIXED_CURRENCY

VariantRecipe5

How a variant differs from its parent; the parts compose ("Heat at 4:5" = color_map + preset).

`preset`可选string \| null
`size`可选PixelSize \| null
`fit`可选ResizeMode	默认: `"REFLOW"`
`colorMap`可选ColorRemap[]	默认: `[]`
`planRow`可选PlanRowRef \| null

VariantSpec5

One variant to create; its recipe composes, and an optional prompt queues one paid scene on it.

`objectId`必填string
`name`必填string
`position`可选BoardPoint \| null
`recipe`可选VariantRecipe
`scenePrompt`可选string \| null

ViewDefinition5

One saved display of a positioning: axes, circle size and number, optional criterion.

`viewId`必填string
`dimensionKeys`必填string[]
`sizeMeasure`必填string
`numberMeasure`必填string
`criterion`可选string \| null

ViewHandledBy可选值 · 2

Whose viewport a view row is: a person's, or the agent working for them (existing values).

可选值: USERAGENT

ViewerRef2

Who is looking: every viewer keeps their own views; the agent never overwrites the person's.

`viewer`必填string
`handledBy`可选ViewHandledBy	默认: `"USER"`

Viewport3

One viewer's ordered saved views of one positioning, guarded by a revision.

`viewer`必填ViewerRef
`definitions`必填ViewDefinition[]
`revision`可选integer	默认: `0`

VisibleField2

Override value: a layer's visibility.

`field`可选string	可选值: `VISIBLE` 默认: `"VISIBLE"`
`visible`必填boolean

WhiteBackgroundRule1

Every pixel outside the product is pure white RGB 255,255,255 (Amazon main image).

kind可选string

可选值: WHITE_BACKGROUND

默认: "WHITE_BACKGROUND"

WindowCapture3

A dataset re-requested over its recent reporting days on every run.

`kind`可选string	Capture style: recent reporting-day window. 可选值: `window` 默认: `"window"`
`lookbackDays`必填integer	Recent reporting days re-read on each sync.
`maxWindowDays`必填integer	Maximum reporting days in one capture request.

WritePolicy1

The store's enabled action-family keys; an empty set keeps every write disabled.

enabled可选string[]

Write families enabled for this store.

默认: []

WriteRefusal3

One catalog refusal: its key, bilingual title and target or direct-only undo meaning.

`key`必填string	Refusal key carried by action rows.
`title`必填StoreLocalizedText	Display name of the reason, in both languages.
`means`可选string \| null	For a plugin code, the standard target reason it is a case of, or REVERT_ONLY for a field only undo rows may change (for example SEO_FIELD_REVERT_ONLY).

MinorUnitMoney2

Exact monetary value stored as ISO minor units plus its currency.

`amount`必填StdMoneyAmount
`currency`必填Currency

DecimalMoney2

An amount with its currency; core never adds two currencies.

`amount`必填number \| string
`currency`必填string

ProviderWriteActionType19

One provider write, with optional neutral intent, typed change and undo/drift policy.

`key`必填string	Approved-write action identifier.
`kind`必填ActionKind	Whether the action sets, adds or removes a target.
`level`必填string	Granularity of the write target: a catalog level key.
`intent`可选ActionIntent \| null	Neutral write meaning; null when the action declares none.
`familyKey`必填string	Owner-facing write family controlled by the store policy.
`changeSchema`必填JsonValue	JSON Schema of the requested change.
`title`必填StoreLocalizedText	Owner-facing name of this write.
`fieldTitles`可选ChangeFieldTitle[]	Human titles of this change's top-level fields. 默认: `[]`
`requires`可选Permission[]	Permissions needed to apply this action. 默认: `[]`
`creates`可选string \| null	Entity level created by an addressable ADD action.
`createdFrom`可选string \| null	Top-level change field containing an ADD's caller-assigned id.
`revertActionKey`可选string \| null	Action used to cancel or restore this action.
`revertNote`可选StoreLocalizedText \| null	Provider-specific undo limitation shown before approval, in both languages.
`refreshDatasetKeys`可选string[]	Datasets captured after this action applies. 默认: `[]`
`fidelity`必填RevertFidelity	Declared completeness of the action's undo.
`drift`必填DriftPolicy	Whether a changed target is refused before apply.
`removeScope`可选RemoveScope	Targets this REMOVE may delete. 默认: `"ELTA_CREATED"`
`revertOnly`可选boolean	Whether this action is valid only while reverting another action. 默认: `false`
`quoted`可选boolean	Whether provider estimates are retained on action outcomes. 默认: `false`

PluginDeclarationCatalog4

Every installed plugin's declaration plus the shared vocabulary.

`object`可选string	Document type: catalog. 可选值: `catalog` 默认: `"catalog"`
`declarations`必填PluginDeclaration[]	Declarations of every installed plugin.
`levels`可选EntityLevel[]	Every level a value may carry, with its title and parent. 默认: `[]`
`refusals`可选WriteRefusal[]	Every refusal an action row may carry, with its title and meaning. 默认: `[]`

TemporalFactKind可选值 · 3

How one fact family is placed in time.

可选值: DAILY_TOTALEVENTSNAPSHOT

StoreLocalizedText2

One display text in both product languages, declared once by the owning plugin.

`en`必填string	English display text.
`zh`必填string	Simplified Chinese display text.

LocalizedText2

One human label in both product languages.

`en`必填string
`zh`必填string

StoreActorKind可选值 · 3

Who caused a change, as the calling service verified it.

可选值: HUMANAGENTSYSTEM

StoreActorRef2

One verified actor: its kind and its stable identity within that kind.

`kind`必填StoreActorKind	Kind of actor that caused the change.
`id`必填string	Verified actor identity.

ActorKind可选值 · 4

Who made an item request or transition.

可选值: HUMANAGENTSYSTEMAPI_KEY

ActorRef2

The verified person, agent, trusted system, or API-key actor.

`kind`必填ActorKind
`id`必填string

CapabilityCatalog5

The public catalog object.

`object`必填string	Public object discriminator. 可选值: `catalog`
`cells`必填CatalogCellView[]	Public capability cells.
`edges`必填CatalogEdgeView[]	Enabled topology edges a caller may traverse.
`motifSections`必填MotifSection[]	Named motif sections available through the Trending route.
`pairs`可选CatalogPairView[]	默认: `[]`

ChangeActionType可选值 · 21

Every change a person or agent makes after create, in three families.

可选值: SET_SETUPADD_ITEMSUPDATE_ITEMSREMOVE_ITEMSSAVE_DIMENSIONDELETE_DIMENSIONSET_PLACEMENTSSAVE_CRITERIONDELETE_CRITERIONSET_RESULTSSAVE_VIEWDELETE_VIEWREORDER_VIEWSCONTINUESET_REVIEWCANCELPROPOSECLASSIFYASSESSSCOREDECIDE

FactValueKind可选值 · 8

What kind of value one item fact holds, which fixes what core may compute from it.

可选值: TEXTCATEGORYNUMBERCOUNTMONEYDATEIMAGEURL

ItemPage4

One ranked pending page and the owner's full matching open count.

`object`可选string	可选值: `item_page` 默认: `"item_page"`
`items`必填TodoItem[] \| AlertItem[] \| ApprovalItem[] \| NotificationItem[]
`next_cursor`可选string \| null
`total`必填integer

PositioningItemPage2

One page of items, groups kept together, for the side panel and agents.

`items`必填ItemRead[]
`nextCursor`可选string \| null

TodoApprovalStatus可选值 · 5

A decision remains separate from ordinary todo completion.

可选值: PENDINGAPPLYINGAPPROVEDREJECTEDWITHDRAWN

ArtifectHostApprovalStatus可选值 · 4

Inbox status mapped exhaustively by the backend adapter from its todo enum.

可选值: PENDINGAPPROVEDREJECTEDEXPIRED

ExportedImage8

One immutable exported image, in board order, with its name, format, findings and AI fact.

`position`必填integer
`designId`必填string
`name`必填string
`preset`必填string	可选值: `amazon.aplus.banneramazon.aplus.comparisonamazon.aplus.four_imageamazon.aplus.headeramazon.aplus.logoamazon.aplus.quadrantamazon.aplus.singleamazon.aplus_premium.full_widthamazon.brand_story.backgroundamazon.brand_story.cardamazon.mainamazon.secondarycustomshopify.blog_featuredshopify.collectionshopify.product`
`format`必填RenderFormat
`asset`必填AssetRef
`findings`必填SlotFinding[]
`aiGenerated`可选boolean	默认: `false`

PostExportedImage2

One design of one immutable export; its HTTPS URL is minted only at Propose.

`export`必填ImageExportRef
`altText`可选string	默认: `""`

ProductOption2

Retain one named dimension/value pair for a Product variant.

`name`必填string
`value`必填string

ShopifyProductOption2

One product option name and its values, e.g. Size: S, M, L.

`name`必填string
`values`必填string[]

ProductImagesActorKind可选值 · 2

Who submitted an edit: the chat agent or the person in the editor (revision provenance).

可选值: AGENTUSER

ShopifyThemeRestoreRevision2

Make an earlier revision's document the new head (Keep/Undo on a change card).

`action`可选string	可选值: `RESTORE_REVISION` 默认: `"RESTORE_REVISION"`
`revision`必填integer

RestoreRevision3

Restore an earlier revision: the whole board (version history) or only object_ids (my-own undo).

`action`可选string	可选值: `RESTORE_REVISION` 默认: `"RESTORE_REVISION"`
`revision`必填integer
`objectIds`可选string[] \| null

PauseReason可选值 · 4

Why sync stopped, including when a top-up is required.

可选值: OWNER_PAUSEDPLAN_REQUIREDSLOT_LIMITTOP_UP_REQUIRED

MonitorPauseReason可选值 · 3

Why a monitor is paused; every value except OWNER is an auto-pause with a notice.

可选值: OWNERFAILURESACCESS

MonitorOwnerScope2

The owner one monitor belongs to: a user or an organization (keble-helpers OwnerType).

`ownerType`必填OwnerType
`ownerId`必填string

OwnerScope1

The single owner every positioning read and write is scoped to.

owner必填string

MonitorAgentBinding2

Which agent narrates: Keble's agent in the chat the monitor was created in, or the owner's own agent.

`kind`必填MonitorAgentKind
`conversationId`可选string \| null

MonitorAgentKind可选值 · 2

Which agent narrates reported cycles, decided by where the monitor was created.

可选值: KEBLE_AGENTOWNER_AGENT

MonitorCadenceUnit可选值 · 5

Units a cadence counts in; MINUTE stays in the contract while v1's floor is 60 minutes.

可选值: MINUTEHOURDAYWEEKMONTH

MonitorCapabilityOffer10

One watchable capability as offered to the agent: backend-authored and safe to show.

`capabilityKey`必填string
`title`必填string
`channelLabel`必填string
`subjectHint`必填string
`policies`必填MonitorFindingPolicy[]
`freshnessLabel`必填string
`fetches`必填boolean
`minInterval`必填string
`readsPerCheck`必填integer
`markets`可选string[]	默认: `[]`

MonitorChangeKind可选值 · 3

The discriminator of what a finding reports.

可选值: NEW_ITEMVALUE_CHANGERANK_MOVE

MonitorChannelDelivery2

Where one channel's delivery of one cycle stands, read from its outbox row.

`channel`必填MonitorDeliveryChannel
`status`必填MonitorDeliveryStatus

MonitorCoverageReason可选值 · 10

The one reason a watch's coverage is PARTIAL or NOT_CHECKED (the digest's "couldn't check X").

可选值: MORE_MAY_EXISTREFS_PENDINGFETCH_DELAYEDSOURCE_STALEACCESSCREDITDAILY_CAPSUBJECT_UNAVAILABLEREAD_FAILEDMONITOR_INACTIVE

MonitorCycleState可选值 · 7

Where one scheduled check is; QUEUED, FETCHING and PROCESSING are open, the rest terminal.

可选值: QUEUEDFETCHINGPROCESSINGREPORTEDNO_CHANGEFAILEDSKIPPED

MonitorDeliveryChannel可选值 · 3

Where one reported cycle (or an auto-pause notice) is delivered; one delivery row per channel.

可选值: INBOXCHATEMAIL

MonitorDeliveryStatus可选值 · 5

Where one delivery row (one channel of one cycle) is; shown on the cycle row.

可选值: PENDINGDISPATCHINGDELIVEREDUNCERTAINGAVE_UP

MonitorFetchHandle1

Opaque handle of one shared fetch, stored on the watch's cycle while it runs.

fetchKey必填string

MonitorFindingItem9

One item as a finding shows it: display-safe labels, its public link, and its times.

`ref`必填MonitorRecordRef
`title`必填string
`channelLabel`必填string
`link`可选string \| null
`image`可选string \| null
`publishedAt`可选string \| null
`observedAt`必填string
`metrics`可选MonitorItemMetric[]	默认: `[]`
`rank`可选integer \| null

MonitorFindingKey5

One finding's identity inside its monitor: cycle, watch, item and what changed.

`cycleSeq`必填integer
`watchKey`必填string
`ref`必填MonitorRecordRef
`change`必填MonitorChangeKind
`metricKey`可选string \| null

MonitorFindingPolicy可选值 · 3

How a watch decides what is new; owned by the monitor, not by the data platform.

可选值: NEW_ITEMSVALUE_CHANGESRANKING

MonitorItemMetric4

One tracked value of an item, with the smallest change worth reporting (backend-authored).

`metricKey`必填string
`label`必填string
`value`必填number \| string
`minChange`必填number \| string

MonitorNewItem1

The item was never reported before by this watch.

kind可选string

可选值: NEW_ITEM

默认: "NEW_ITEM"

MonitorRankMove3

An entry entered (was None) or rose in a ranked list.

`kind`可选string	可选值: `RANK_MOVE` 默认: `"RANK_MOVE"`
`was`可选integer \| null
`now`必填integer

MonitorRecordRef2

One record of the shared data, opaque to the core: a subject the agent found, or an item a fetch found.

`recordKind`必填string
`recordKey`必填string

MonitorSetCadence2

Change the schedule; the next due is recomputed, an open cycle keeps its frozen spec.

`command`可选string	可选值: `SET_CADENCE` 默认: `"SET_CADENCE"`
`cadence`必填MonitorCadence

MonitorSetDelivery2

Change the channel toggles.

`command`可选string	可选值: `SET_DELIVERY` 默认: `"SET_DELIVERY"`
`delivery`必填MonitorDelivery

MonitorSetWatches2

Replace the watch list at once: compiles under the spec-revision fence, never re-enters setup.

`command`可选string	可选值: `SET_WATCHES` 默认: `"SET_WATCHES"`
`watches`必填MonitorWatchRequest[]

MonitorValueChange5

A tracked value moved by at least its minimum change since it was last reported (was -> now).

`kind`可选string	可选值: `VALUE_CHANGE` 默认: `"VALUE_CHANGE"`
`metricKey`必填string
`label`必填string
`was`必填number \| string
`now`必填number \| string

MonitorWatchCoverage可选值 · 4

What one watch could check this cycle, so "nothing new" is never "could not check".

可选值: COMPLETEPARTIALNOT_CHECKEDNO_DATA

MonitorWatchCycle12

One watch's progress and result inside one cycle.

`watch`必填MonitorWatch
`fetch`可选MonitorFetchHandle \| null
`fetchDeadlineAt`可选string \| null
`fetchDelayed`可选boolean	默认: `false`
`fetchReady`可选boolean	默认: `false`
`found`可选MonitorRecordRef[]	默认: `[]`
`coverage`可选MonitorWatchCoverage \| null
`reason`可选MonitorCoverageReason \| null
`findings`可选integer	默认: `0`
`readCalls`可选integer	默认: `0`
`windowEnd`可选string \| null
`dataAsOf`可选string \| null

MonitorWatchRequest4

What the agent sends for one watch: a capability, a finding policy and its subjects.

`capabilityKey`必填string
`policy`必填MonitorFindingPolicy
`subjects`必填MonitorRecordRef[] \| string[]
`market`可选string \| null

错误码

被拒绝的调用会返回一个错误体，包含错误码和你所用语言的说明。

错误码	含义	怎么办
`INVALID_API_KEY`	密钥不存在或已撤销。	创建新密钥并替换旧密钥。
`SIGNED_IN_ONLY`	这是网页内操作，API 密钥不可调用。	在 Keble 网页登录后操作。
`ACCOUNT_DISABLED`	账号已注销。	如需恢复请联系 hi@keble.ai。
`LAST_ORG_OWNER`	组织至少需要一位所有者。	请先将其他成员设为所有者。
`ORG_DELETE_BLOCKED`	组织仍有余额、生效中的 Pro 或店铺，暂时不能删除。	按错误中列出的项逐一处理（将余额用至 0、等待 Pro 到期、移除店铺）后再删除。
`IDENTITY_VERIFICATION_REQUIRED`	账户需要先验证身份。	在 Keble 网页完成验证后重试。
`INVALID_REQUEST`	部分参数不正确，错误体会列出字段。	修正列出的字段后重试。
`NOT_FOUND`	对象不存在，或你的账户无权查看。	检查 id，或重新列出以获取当前的 id。
`STATE_CONFLICT`	调用被拒绝。	查看错误体中的说明。
`ACCESS_REFUSED`	调用被拒绝。	查看错误体中的说明。
`INVALID_QUERY`	调用被拒绝。	查看错误体中的说明。
`RATE_LIMITED`	当前方案在本时段的请求次数已用完。	按 Retry-After 的时间等待，或升级方案。
`INSUFFICIENT_BALANCE`	余额不足以完成这次调用。	充值后重试。
`FEATURE_UNAVAILABLE`	该功能暂未开放。	改用其他能力，或联系支持。
`STORE_PLAN_REQUIRED`	免费版不能同步店铺。	升级 Pro 或充值。
`STORE_SLOT_LIMIT`	当前方案同时只能同步 1 个店铺，槽位已被其他店铺占用。	暂停另一个店铺，或充值。
`STORE_TOP_UP_REQUIRED`	付费余额已用完，店铺已暂停。	充值后恢复。
`STORE_CHANGE_IN_PROGRESS`	店铺正在更新。	请几秒后重试。
`APPROVAL_EXPIRED`	修改提议在批准前已过期。	重新提议这次修改。
`UPGRADE_REQUIRED`	需要 Pro、企业版或账户余额。	在 Keble 网页升级或充值。
`LEGACY_PLAN`	旧版方案在新版本中不再支持。	在 Keble 网页转换会员。
`TRYOUT_LIMIT_REACHED`	免费试用次数已用完。	登录后继续。
`FREE_ALLOWANCE_UNAVAILABLE`	已有关联账号在使用免费额度。	升级 Pro 或充值即可继续使用。
`UPSTREAM_UNAVAILABLE`	Keble 依赖的服务暂时不可用。	稍后重试。
`UPSTREAM_FAILED`	所需服务暂时故障。	请稍后重试。
`TIMED_OUT`	调用超时。	重试；如果反复出现，请缩小问题范围。

`kind`可选ArtifectKind \| null
`storeId`可选string \| null
`limit`可选integer	默认: `5`
`before`可选string \| null