> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # 读取 SEO 研究结果 > 读取已有请求的规范化输出、交付状态和总费用。使用首次调用返回的 result_url。 通过 SEO 研究返回的 result\_url，读取相同 Run 的规范化输出、业务 result\_status 和总费用。HTTP 200 仍可能包含 result\_status=pending。此认证读取不创建 Run、不调用数据提供商，也不恢复切换。GET /v1/runs/:id 仍返回单个 Run 的原生输出。结果上下文带签名，绑定工作空间，并对每个 Run 按当前 API Key Policy 检查权限。 ## OpenAPI ````yaml /openapi.zh.json get /v1/solutions/gtm/seo_research/result openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: 一个 API Key，无需合同，按次付费，即可调用批量采购的付费 API。每个响应包含 x-request-id；所有错误正文采用统一结构。 servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/solutions/gtm/seo_research/result: get: tags: - Solutions summary: 读取 SEO 研究结果 description: >- 通过 SEO 研究返回的 result_url，读取相同 Run 的规范化输出、业务 result_status 和总费用。HTTP 200 仍可能包含 result_status=pending。此认证读取不创建 Run、不调用数据提供商，也不恢复切换。GET /v1/runs/:id 仍返回单个 Run 的原生输出。结果上下文带签名，绑定工作空间，并对每个 Run 按当前 API Key Policy 检查权限。 operationId: gtm-seo-research-result parameters: - name: token in: query schema: type: string minLength: 1 maxLength: 16384 description: result_url 中返回的不透明结果上下文。保持原样，并使用有权读取所列全部 Run 的 API Key 认证。 required: true responses: '200': description: SeoResearchResult content: application/json: schema: $ref: '#/components/schemas/SeoResearchResult' '400': description: ValidationFailed content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenEncoded' '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/NotFoundEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' security: - bearer: [] components: schemas: SeoResearchResult: type: object properties: id: type: string run_url: type: string description: 在控制台打开 Run，需要工作空间成员权限。 provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。 failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Run 失败原因，仅在 status 为 FAILED 时非 null。 input: type: object output: anyOf: - anyOf: - type: object properties: items: type: array items: type: object properties: keyword: anyOf: - type: string - type: 'null' volume: anyOf: - type: integer - type: 'null' cpc_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' semrush_keyword_difficulty: anyOf: - type: integer - type: 'null' serpstat_keyword_difficulty: anyOf: - type: integer - type: 'null' dataforseo_keyword_difficulty: anyOf: - type: integer - type: 'null' ahrefs_keyword_difficulty: anyOf: - type: integer - type: 'null' intent: anyOf: - type: string - type: 'null' required: - keyword - volume - cpc_usd - semrush_keyword_difficulty - serpstat_keyword_difficulty - dataforseo_keyword_difficulty - ahrefs_keyword_difficulty - intent additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: position: anyOf: - type: integer - type: 'null' url: anyOf: - type: string - type: 'null' domain: anyOf: - type: string - type: 'null' title: anyOf: - type: string - type: 'null' snippet: anyOf: - type: string - type: 'null' required: - position - url - domain - title - snippet additionalProperties: false required: - items additionalProperties: false - type: object properties: organic_keywords: anyOf: - type: integer - type: 'null' organic_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' organic_traffic_value_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' paid_keywords: anyOf: - type: integer - type: 'null' paid_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - organic_keywords - organic_traffic - organic_traffic_value_usd - paid_keywords - paid_traffic additionalProperties: false - type: object properties: items: type: array items: type: object properties: keyword: anyOf: - type: string - type: 'null' position: anyOf: - type: integer - type: 'null' url: anyOf: - type: string - type: 'null' volume: anyOf: - type: integer - type: 'null' cpc_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - keyword - position - url - volume - cpc_usd - traffic additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: domain: anyOf: - type: string - type: 'null' common_keywords: anyOf: - type: integer - type: 'null' organic_keywords: anyOf: - type: integer - type: 'null' organic_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - domain - common_keywords - organic_keywords - organic_traffic additionalProperties: false required: - items additionalProperties: false - type: object properties: backlinks: anyOf: - type: integer - type: 'null' referring_domains: anyOf: - type: integer - type: 'null' semrush_authority_score: anyOf: - type: integer - type: 'null' dataforseo_rank: anyOf: - type: integer - type: 'null' serpstat_domain_rank: anyOf: - type: integer - type: 'null' dofollow_backlinks: anyOf: - type: integer - type: 'null' nofollow_backlinks: anyOf: - type: integer - type: 'null' required: - backlinks - referring_domains - semrush_authority_score - dataforseo_rank - serpstat_domain_rank - dofollow_backlinks - nofollow_backlinks additionalProperties: false - type: object properties: items: type: array items: type: object properties: source_url: anyOf: - type: string - type: 'null' target_url: anyOf: - type: string - type: 'null' anchor: anyOf: - type: string - type: 'null' source_ahrefs_domain_rating: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' source_semrush_authority_score: anyOf: - type: integer - type: 'null' source_dataforseo_rank: anyOf: - type: integer - type: 'null' dofollow: anyOf: - type: boolean - type: 'null' first_seen_at: anyOf: - type: string - type: 'null' required: - source_url - target_url - anchor - source_ahrefs_domain_rating - source_semrush_authority_score - source_dataforseo_rank - dofollow - first_seen_at additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: domain: anyOf: - type: string - type: 'null' ahrefs_domain_rating: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' semrush_authority_score: anyOf: - type: integer - type: 'null' dataforseo_rank: anyOf: - type: integer - type: 'null' backlinks: anyOf: - type: integer - type: 'null' dofollow_backlinks: anyOf: - type: integer - type: 'null' first_seen_at: anyOf: - type: string - type: 'null' required: - domain - ahrefs_domain_rating - semrush_authority_score - dataforseo_rank - backlinks - dofollow_backlinks - first_seen_at additionalProperties: false required: - items additionalProperties: false - type: object properties: ahrefs_domain_rating: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - ahrefs_domain_rating additionalProperties: false - type: object properties: dataforseo_task_id: anyOf: - type: string - type: 'null' crawl_progress: anyOf: - type: string - type: 'null' crawl_stop_reason: anyOf: - type: string - type: 'null' pages_crawled: anyOf: - type: integer - type: 'null' dataforseo_onpage_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' broken_links: anyOf: - type: integer - type: 'null' non_indexable: anyOf: - type: integer - type: 'null' duplicate_title: anyOf: - type: integer - type: 'null' duplicate_description: anyOf: - type: integer - type: 'null' duplicate_content: anyOf: - type: integer - type: 'null' required: - dataforseo_task_id - crawl_progress - crawl_stop_reason - pages_crawled - dataforseo_onpage_score - broken_links - non_indexable - duplicate_title - duplicate_description - duplicate_content additionalProperties: false - type: object properties: items: type: array items: type: object properties: keyword: anyOf: - type: string - type: 'null' volume: anyOf: - type: integer - type: 'null' cpc_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' semrush_keyword_difficulty: anyOf: - type: integer - type: 'null' dataforseo_keyword_difficulty: anyOf: - type: integer - type: 'null' positions: type: object additionalProperties: anyOf: - type: integer - type: 'null' required: - keyword - volume - cpc_usd - semrush_keyword_difficulty - dataforseo_keyword_difficulty - positions additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: domain: anyOf: - type: string - type: 'null' dataforseo_rank: anyOf: - type: integer - type: 'null' backlinks_per_target: type: object additionalProperties: anyOf: - type: integer - type: 'null' required: - domain - dataforseo_rank - backlinks_per_target additionalProperties: false required: - items additionalProperties: false - type: object properties: url: anyOf: - type: string - type: 'null' status_code: anyOf: - type: integer - type: 'null' title: anyOf: - type: string - type: 'null' description: anyOf: - type: string - type: 'null' canonical: anyOf: - type: string - type: 'null' dataforseo_onpage_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' internal_links: anyOf: - type: integer - type: 'null' external_links: anyOf: - type: integer - type: 'null' required: - url - status_code - title - description - canonical - dataforseo_onpage_score - internal_links - external_links additionalProperties: false - type: object properties: items: type: array items: type: object properties: month: anyOf: - type: string - type: 'null' organic_keywords: anyOf: - type: integer - type: 'null' organic_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' organic_traffic_value_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' paid_keywords: anyOf: - type: integer - type: 'null' paid_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - month - organic_keywords - organic_traffic - organic_traffic_value_usd - paid_keywords - paid_traffic additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: url: anyOf: - type: string - type: 'null' platform: anyOf: - type: string - type: 'null' mentions: anyOf: - type: integer - type: 'null' ai_search_volume: anyOf: - type: integer - type: 'null' is_target_domain: anyOf: - type: boolean - type: 'null' required: - url - platform - mentions - ai_search_volume - is_target_domain additionalProperties: false required: - items additionalProperties: false - type: object properties: ahrefs_ai_citations: anyOf: - type: integer - type: 'null' ahrefs_ai_cited_pages: anyOf: - type: integer - type: 'null' ahrefs_ai_citations_by_platform: anyOf: - type: object additionalProperties: anyOf: - type: integer - type: 'null' - type: 'null' dataforseo_ai_mentions_by_platform: anyOf: - type: object additionalProperties: anyOf: - type: integer - type: 'null' - type: 'null' dataforseo_ai_search_volume_by_platform: anyOf: - type: object additionalProperties: anyOf: - type: integer - type: 'null' - type: 'null' required: - ahrefs_ai_citations - ahrefs_ai_cited_pages - ahrefs_ai_citations_by_platform - dataforseo_ai_mentions_by_platform - dataforseo_ai_search_volume_by_platform additionalProperties: false - type: 'null' description: >- 各操作的规范化字段。原生输出保留在 Run 中，可通过 GET /v1/runs/:id 读取。未报告的值为 null，金额为美元。权威度保留响应方口径和名称，不换算：ahrefs_domain_rating 为 0–100，semrush_authority_score 为 0–100，dataforseo_rank 为 0–1000，serpstat_domain_rank 为 0–100。关键词难度同样分为 semrush_keyword_difficulty、serpstat_keyword_difficulty、dataforseo_keyword_difficulty、ahrefs_keyword_difficulty，各自模型范围为 0–100。只填写实际响应方字段，其他家为 null。volume、traffic、cpc 为响应方估算，只宜在同一家内比较，见 runs[].provider。有效空结果的 result_status 为 no_result，保留操作结构，items 为 [] 或各字段为 null。 - keyword_overview: items[]: keyword, volume, cpc_usd, semrush_keyword_difficulty, serpstat_keyword_difficulty, dataforseo_keyword_difficulty, ahrefs_keyword_difficulty, intent - keyword_ideas: items[]: 与 keyword_overview 相同的行结构 - serp: items[]: position ，自然排名，1 为第一条自然结果，不计 SERP 特殊结果, url, domain, title, snippet ，仅自然结果 - domain_overview: organic_keywords, organic_traffic, organic_traffic_value_usd, paid_keywords, paid_traffic - ranked_keywords: items[]: keyword, position ，自然排名，1 为第一条自然结果，不计 SERP 特殊结果, url, volume, cpc_usd, traffic - organic_competitors: items[]: domain, common_keywords, organic_keywords ，竞争对手总数, organic_traffic ，排除目标域及其子域 - backlinks_overview: backlinks, referring_domains, semrush_authority_score, dataforseo_rank, serpstat_domain_rank, dofollow_backlinks, nofollow_backlinks - backlinks: items[]: source_url, target_url, anchor, source_ahrefs_domain_rating, source_semrush_authority_score, source_dataforseo_rank, dofollow, first_seen_at ，ISO 8601 UTC；Semrush 未注明时区，不加 Z 后缀。各家均每个链接一行 - referring_domains: items[]: domain, ahrefs_domain_rating, semrush_authority_score, dataforseo_rank, backlinks, dofollow_backlinks, first_seen_at ，ISO 8601 UTC；Semrush 未注明时区，不加 Z 后缀 - domain_rating: ahrefs_domain_rating - site_audit: dataforseo_task_id ，用于 DataForSEO OnPage 报告接口的输入, crawl_progress, crawl_stop_reason ，DataForSEO 词汇, pages_crawled, dataforseo_onpage_score, broken_links, non_indexable, duplicate_title, duplicate_description, duplicate_content - keyword_gap: items[]: keyword, volume, cpc_usd, semrush_keyword_difficulty, dataforseo_keyword_difficulty, positions {domain: 自然排名；null 表示不在前 100 名}，键为传入域名。Semrush 返回任一域名有排名的关键词并集；DataForSEO 返回竞争对手有排名而你没有的关键词 - backlink_gap: items[]: domain, dataforseo_rank, backlinks_per_target {竞争域名: 数量} - page_audit: url, status_code, title, description, canonical, dataforseo_onpage_score, internal_links, external_links - visibility_history: items[]: month, organic_keywords, organic_traffic, organic_traffic_value_usd, paid_keywords, paid_traffic - ai_citations: items[]: url, platform, mentions, ai_search_volume, is_target_domain ，提及该域名的 AI 回答中被引用最多的页面，可来自任意网站 - ai_visibility: ahrefs_ai_citations, ahrefs_ai_cited_pages, ahrefs_ai_citations_by_platform {platform: 引用次数}, dataforseo_ai_mentions_by_platform {platform: 提及次数}, dataforseo_ai_search_volume_by_platform {platform: AI 搜索量}。各家仅填自己的字段，不跨家汇总 provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。 error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: |- 仅在 status 为 COMPLETED 时非 null。 - 2xx 响应：output 为任意结构的数据提供商原生 JSON；正文为空时为 null。 - 非 2xx 响应：error 包含数据提供商错误正文，output 为 null。 两种正文均会移除敏感字段。 charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。 - type: 'null' description: 此 Solution 响应所含 runs 的总费用，全部 Run 结算前为 null。每个 Run 保留各自费用；失败也可能收费。 charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: 单个 Run 的计费依据；多个 Run 汇总时为 null。各项费用请查看 runs[].charge_basis。 stoppable: type: boolean description: 当前是否可接受停止请求。不保证能在分派前停止 Run。 stop_requested_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' description: 请求停止的时间。如果已开始分派，Run 仍可能继续。 created_at: type: string description: ISO 8601 UTC 时间戳。 format: date-time started_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: |- 已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 action: type: string enum: - keyword_overview - keyword_ideas - serp - domain_overview - ranked_keywords - organic_competitors - backlinks_overview - backlinks - referring_domains - domain_rating - site_audit - ai_visibility - keyword_gap - backlink_gap - page_audit - visibility_history - ai_citations result_status: type: string enum: - success - no_result - error - pending description: >- 业务交付状态，与 status 中的最终 Run 生命周期独立。no_result 为有效空结果；error 表示数据提供商输出无法交付。 error: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' runs: type: array items: type: object properties: id: type: string run_url: type: string description: 在控制台打开 Run，需要工作空间成员权限。 provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。 failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Run 失败原因，仅在 status 为 FAILED 时非 null。 input: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false output: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。 required: - http_status additionalProperties: false - type: 'null' charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。 - type: 'null' description: >- 最终费用，精确的美元十进制字符串。QUEUED 或 RUNNING 时为 null。FAILED 状态的 Run 仍可能按接口定价产生非零费用。 charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: 计算费用所用的价格条款。结算前或未尝试调用数据提供商时为 null。 stoppable: type: boolean description: 当前是否可接受停止请求。不保证能在分派前停止 Run。 stop_requested_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' description: 请求停止的时间。如果已开始分派，Run 仍可能继续。 created_at: type: string description: ISO 8601 UTC 时间戳。 format: date-time started_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: |- 已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false result_url: type: string description: >- 通过认证读取规范化结果和总费用的只读 URL 路径，配合 API 服务地址使用。不创建 Run，也不恢复切换。GET /v1/runs/:id 仍返回原生单个 Run。 required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata - action - result_status - error - runs - result_url additionalProperties: false ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false NotFoundEncoded: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.