OpenMax
免费试用

Apps API · 数据类型

Apps API 请求和回包里用到的对象类型。

← 全部分组

AcceptDeliveredIssueRequestBody

字段 类型 必填 说明
source string: im, explicit, text_card_proxy 是 Acceptance source

AcceptInvitationData

字段 类型 必填 说明
member_id string (uuid) 是 Newly created member UUID
org_id string (uuid) 是 Organization joined
role_slug string 是 Assigned role slug

AcceptInvitationRequestBody

字段 类型 必填 说明
token string Invitation token (for token-based acceptance, e.g. agent invitations)

AcceptIssuePlanRequestBody

字段 类型 必填 说明
expected_plan_token string Optional current_plan_token of the plan the caller reviewed. Send it only to decide an issue in pending_plan, and only as the issue owner: with a token, a non-owner gets 403, a silent automation's or archived issue is refused, an issue not in pending_plan gets 412, and a plan that has changed since gets 412 WORK_ISSUE_PLAN_CHANGED; nothing is accepted in any of these cases. Omit to accept without the token rules; null is invalid
source string Origin of the plan acceptance (e.g. explicit, text_card_proxy)

AckSyncCommRequestBody

字段 类型 必填 说明
app_version string Client app version
device_id string 是 Device ID
platform string Client platform
seq integer (int64) 是 Highest processed sync sequence

ActivateIssueRequestBody

字段 类型 必填 说明
source string: lead_chat, ui, event_binding, system Activation source. Defaults to ui (the human/UI action path) when omitted.

AddMemberRequestBody

字段 类型 必填 说明
member_id string (uuid) 是 OrgMember/Participant UUID
role string: UNSPECIFIED, MEMBER, ADMIN, OWNER, PUBLISHER, SUBSCRIBER Member role

AddMessageReactionRequestBody

字段 类型 必填 说明
reaction_code string 是 Reaction code from the server-side reaction registry (e.g. thumbs_up, heart)

AddProjectMemberRequestBody

字段 类型 必填 说明
member_id string (uuid) 是 Member UUID
role string: member, lead 是 Project member role

AddonHistoryDTO

字段 类型 必填 说明
addon_id string 是
created_at string (date-time)
ended_at string (date-time)
identity_id string
provision_spec AgentProvisionDTO
retainer_points integer (int64) 是
runtime_billing_enabled boolean 是
runtime_rate AgentRuntimeRateDTO
sku_code string 是
status string 是
tier string 是
usage_points_day integer (int64) 是

AddonOutstandingDTO

字段 类型 必填 说明
addon_status string 是 active|suspended|paused|pending_end|ended|…
outstanding array of OutstandingItemDTO 是 Per-item debt breakdown (kind: arrears | restart_daily); empty when there is no debt
total_outstanding_points integer (int64) 是 Sum of outstanding[].points; 0 with an empty breakdown means there is no outstanding debt and the add-on can be resumed directly (resume charges nothing)

AddonSummaryDTO

字段 类型 必填 说明
item_id string 是
member_id string Org member id of the platform_created agent this addon delivered; empty when the add-on has no platform-created agent
points_per_cycle integer (int64) 是
runtime_billing_enabled boolean 是
sku_code string 是
status string 是
tier string 是

AdminAgentStorageDTO

字段 类型 必填 说明
actual_observed_at string (date-time) When the agent collected the actual_total_gb observation.
actual_total_gb number (double) Observed mounted disk size in GiB (statfs total / 2^30, 2 decimals), slightly below total_gb because of filesystem overhead. Omitted when the agent has not reported disk metrics.
addon_gb integer (int32) 是
addon_id string 是
agent_identity_id string 是
base_gb integer (int32) 是
inflight_order AdminAgentStorageOrderDTO 是
max_total_gb integer (int32) 是
micro_per_day integer (int64) 是
org_id string 是
tiers array of AdminAgentStorageTierDTO 是
total_gb integer (int32) 是

AdminAgentStorageOrderDTO

字段 类型 必填 说明
agent_identity_id string 是
channel string 是 self_service|admin
completed_at string (date-time)
created_at string (date-time)
failure_reason string
from_total_gb integer (int32) 是
operator_id string 是
order_id string 是
org_id string 是
size_gb integer (int32) 是
slow boolean 是 Resizing for longer than usual
status string 是 resizing|active|failed
target_total_gb integer (int32) 是
tier_code string 是

AdminAgentStorageTierDTO

字段 类型 必填 说明
micro_per_day integer (int64) 是 Credits/day in micro-Credits (monthly / 30, not rounded)
monthly_points integer (int64) 是
size_gb integer (int32) 是
tier_code string 是 storage_10|storage_50|storage_100|storage_200 (storage_10 admin-only)

AgentAvatarData

字段 类型 必填 说明
avatar_url string 是 Saved avatar URL; null when the default avatar is used
member_id string (uuid) 是 Agent member UUID

AgentCapabilityTagsData

字段 类型 必填 说明
member_id string (uuid) 是 Agent member UUID
tags array of CapabilityTagDTO 是 The agent's capability tags after the write

AgentChannelBindingItem

字段 类型 必填 说明
account_label string 是
agent_member_id string 是
channel_type string 是
created_at string (date-time)
id string 是
last_error string
last_reported_at string (date-time)
qr_png_base64 string
qr_updated_at string (date-time)
request_id string
runtime_status string
source string
status string 是
updated_at string (date-time)

AgentChannelCatalogItem

字段 类型 必填 说明
binding AgentChannelBindingItem
definition AgentChannelDefinitionItem 是

AgentChannelDefinitionItem

字段 类型 必填 说明
category string 是
channel_type string 是
coming_soon boolean 是
description_key string 是
display_name string 是
fields array of AgentChannelFormFieldItem 是
icon string 是
labels object 是

AgentChannelFormFieldItem

字段 类型 必填 说明
field_type string 是
key string 是
labels object 是
options array of string
placeholder string
readonly boolean 是
required boolean 是
sensitive boolean 是
value string

AgentCollabConversationItem

字段 类型 必填 说明
can_send boolean 是 Always false for owner observation
id string (uuid) 是 Conversation UUID
last_message_at string (date-time) 是 Last message time
last_message_id integer (int64) Last message ID
last_message_preview LastMessagePreviewItem Last message preview
name string Conversation name
participants array of AgentCollabParticipantItem 是 Conversation participants
read_only_reason string: observer 是 Why this view is read-only
shape string: agent_dm, agent_group 是 Agent collaboration shape
type string 是 Conversation type

AgentCollabParticipantItem

字段 类型 必填 说明
avatar_url string Member avatar URL
display_name string 是 Member display name
kind string: agent, system, human 是 Member kind
member_id string (uuid) 是 Member UUID
status string: active, suspended, departed 是 Member status

AgentCreditCapDTO

字段 类型 必填 说明
addon_id string 是
agent_identity_id string (uuid) 是
block_reason string: ``, daily, monthly, both 是 Which cap blocks the agent when blocked is true: daily, monthly or both; empty when not blocked.
blocked boolean 是
consumed_micro integer (int64) 是
control_applied_revision integer (int64) 是
daily_consumed_micro integer (int64) 是 Counted consumption in the current Beijing-time (UTC+8) day, reported even without a daily cap.
daily_effective_limit_micro integer (int64) 是 daily_points in micro-points; 0 without a daily cap.
daily_points integer (int64) 是 Configured daily cap in points; 0 without a daily cap.
day_end string (date-time) Next daily reset (00:00 Beijing time (UTC+8)).
day_start string (date-time) Start (00:00 Beijing time (UTC+8)) of the day that daily_consumed_micro covers.
effective_limit_micro integer (int64) 是
has_daily_limit boolean 是 True when a daily cap is configured; independent of has_limit (monthly).
has_limit boolean 是
monthly_points integer (int64) 是
period_end string (date-time)
period_start string (date-time)
revision integer (int64) 是
updated_at string (date-time)

AgentDMEligibilityItem

字段 类型 必填 说明
agent_member_id string (uuid) 是 Agent member UUID, as requested
can_dm boolean 是 True only when status is allowed: the caller may start a DM with this agent
status string: allowed, not_allowed, not_found, unknown 是 allowed: the caller owns the agent, or its DM policy lets the caller in. not_allowed: its DM policy does not let the caller in. not_found: not an agent, not active (suspended / departed), not in the caller's organization, removed, or unknown id (not distinguished). unknown: the agent's DM policy could not be read in time (failed or still pending at the server's read deadline); callers should treat unknown as not selectable. The policy itself is never returned.

AgentGroupPolicyItem

字段 类型 必填 说明
allow_from array of string 是 Member UUIDs allowed to trigger the agent
conversation_id string (uuid) 是 Conversation UUID
mode string 是 Group response mode

AgentModelOption

字段 类型 必填 说明
display_name string 是
key string 是

AgentModelResponseBody

字段 类型 必填 说明
data AgentModelView 是
request_id string 是
server_time string (date-time) 是

AgentModelView

字段 类型 必填 说明
apply_state string
available_models array of AgentModelOption
configurable boolean 是
desired_model string
desired_model_name string
effective_model string
effective_model_name string
last_error string
member_id string 是
runtime string
visible boolean 是

AgentOverviewItemDTO

字段 类型 必填 说明
avatar_url string
credit_cap AgentCreditCapDTO Monthly and daily credit caps and current counted consumption; omitted for external agents or when unavailable
display_name string 是
estimated_monthly_points integer (int64) retainer + usage_points_day×30 (billing-known agents only)
identity_id string (uuid) 是
member_id string (uuid) 是
provision_spec AgentProvisionDTO
retainer_points_month integer (int64) Monthly retainer points for agents on monthly-retainer billing; omitted for runtime-billed agents
runtime_billing_enabled boolean 是
runtime_rate AgentRuntimeRateDTO
source string: workspace_purchase, external 是 workspace_purchase = billed addon; external = not billed
status string 是 Member status (active/suspended/departed)
tier string standard|advanced (billing-known agents only)

AgentOverviewListResponseBody

字段 类型 必填 说明
data array of AgentOverviewItemDTO 是 Response payload
pagination AgentOverviewPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

AgentOverviewPageMetadata

字段 类型 必填 说明
has_more boolean 是 Whether another page exists
page integer (int32) 是 Page that produced this data (1-based); 1 when unpaged
page_size integer (int32) 是 Effective page size; 0 means unpaged (full roster returned)
total integer (int64) 是 Total items after q filtering, across all pages

AgentProfile

字段 类型 必填 说明
billing_suspended boolean True when the agent is stopped by billing enforcement (arrears); false otherwise, including a credit-cap stop (see credit_cap_reached). Omitted when unknown. Same rule as the member list.
credit_cap_reached boolean True when the agent credit cap (daily or monthly) is the effective stop reason; omitted when not capped or unknown. Same rule as the member list.
display_name string 是 Display name
kind string: agent 是 Member type (always agent)
member_id string (uuid) 是 Agent member UUID
online_status string: online, offline, unknown Online status (unknown if it cannot be determined)
skills array of SkillDTO Skills the agent self-reports (objective dimension; present only when include=capabilities)
status string: active, suspended, departed 是 Member status
tags array of CapabilityTagDTO Human-declared capability tags (subjective dimension; present only when include=capabilities)

AgentProvisionDTO

字段 类型 必填 说明
limit_cpu string
limit_memory string
request_cpu string
request_memory string
storage string

AgentRuntimeCommandResult

字段 类型 必填 说明
accepted_at string (date-time) When agent-manager accepted the command (if returned)
command string: restart, interrupt, pause, resume, resources 是 Runtime command issued
member_id string (uuid) 是 Agent member UUID the command targeted
operation_id string Agent-manager operation ID for tracing the command (if returned)

AgentRuntimeMetricsData

字段 类型 必填 说明
cost RuntimeMetricsCost 是 Usage cost metrics
member_id string (uuid) 是 Agent member UUID
rate_limit_pct number (double) Rate limit usage percentage (5h window)
reported_at string (date-time) When the agent last reported metrics
resources RuntimeMetricsResources 是 System resource metrics
runtime RuntimeMetricsRuntime 是 Runtime state and model info
version string Reporting agent's own version, e.g. 2.7.5

AgentRuntimeRateDTO

字段 类型 必填 说明
effective_from string (date-time)
online_points_micro_per_minute integer (int64) 是
sleep_points_micro_per_minute integer (int64) 是
version integer (int64) 是

AnalyticsCard

字段 类型 必填 说明
total integer (int64) 是 Current cumulative total
trend7d array of integer (int64) 是 Per-day cumulative total over the last 7 days (oldest first)
wow_pct number (double) 是 Week-over-week change percent vs one week ago; null when the count one week ago was 0, because percent change from zero is undefined (a client must not render it as 0%)

AnalyticsCards

字段 类型 必填 说明
agents AnalyticsCard 是
humans AnalyticsCard 是
issues AnalyticsCard 是
projects AnalyticsCard 是

AnalyticsOverview

字段 类型 必填 说明
cards AnalyticsCards 是

AppAgentGrantItem

字段 类型 必填 说明
agent_member_id string (uuid) 是 The Agent the app may act as
app_id string (uuid) 是 The app
created_at string (date-time) 是 When the owner granted it
granted_by_member_id string (uuid) 是 The Agent's owner who granted it
id string (uuid) 是 Grant ID
installation_id string (uuid) 是 The app installation the grant belongs to
revoke_reason string: revoked_by_owner, revoked_by_admin, owner_changed, agent_left, app_uninstalled, app_suspended 是 Why it is revoked; null while active
revoked_at string (date-time) 是 When it was revoked; null while active or when revoked only in effect
status string: active, revoked 是 Effective status, derived from the live state: a grant whose Agent left, whose owner changed or whose installation is no longer active reads as revoked immediately, before the revocation is recorded

AppAgentGrantResponseBody

字段 类型 必填 说明
data AppAgentGrantItem 是 The grant
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

AppOAuthError

字段 类型 必填 说明
error string: invalid_request, invalid_client, invalid_grant, invalid_scope, unsupported_grant_type, unsupported_token_type 是 OAuth error code (RFC 6749 §5.2): invalid_client with 401, any other with 400. unsupported_token_type only on revocation (RFC 7009); invalid_grant, invalid_scope and unsupported_grant_type only on the token endpoint
error_description string Human-readable error detail

AppTokenBody

字段 类型 必填 说明
access_token string App access token (JWT, 15 minutes)
error string OAuth error code (RFC 6749 §5.2)
error_description string Human-readable error detail
expires_in integer (int64) Access token lifetime in seconds (900)
id_token string OpenID Connect id_token (verify with get-app-jwks)
refresh_token string Refresh token; only for grants carrying offline_access
scope string Granted scopes, space-delimited
token_type string Bearer
user AppTokenUser The member the token acts as

AppTokenUser

字段 类型 必填 说明
email string Login email; in this token response (and the id_token email claim) only when the grant carries org:me.email:read. That scope governs only these two places: GET /api/v1/me, granted by the implicit org:me:read, returns the login email regardless
member_id string (uuid) 是 The member ID; the stable user identifier the app binds its account to
name string 是 Display name
org_id string (uuid) 是 The member's organization
org_role string: owner, admin, member 是 Organization role, for the app's reference only (the platform never authorizes on it)

ApprovalItem

字段 类型 必填 说明
action string Requested action
approver_member_id string (uuid) Approver member UUID
auto_approved boolean 是 Whether the request was auto-approved
cancel_reason string Cancellation reason
created_at string (date-time) 是 Creation time
decided_at string (date-time) Decision time
decided_by_member_id string (uuid) Decision actor member UUID
decision_reason string Decision reason
detail any Approval request detail
expired_reason string Expiry reason
granted_effect any Persisted authorization effect metadata
id string (uuid) 是 Approval request UUID
kind string: resource_grant, external_share, app_publish, app_install 是 Approval request kind (app_publish / app_install are created by the Apps API)
org_id string (uuid) 是 Organization UUID
policy_id string (uuid) Approval policy UUID
request_expires_at string (date-time) Request expiry time
request_reason string Request reason
requester_member_id string (uuid) 是 Requester member UUID
scope_id string (uuid) 是 Scope/resource UUID
scope_type string 是 Scope/resource type
status string: pending, approved, rejected, cancelled, expired 是 Approval status
updated_at string (date-time) 是 Last update time

AttachmentItem

字段 类型 必填 说明
artifact_id string 是 Artifact UUID
content_type string 是 Content type
file_name string 是 File name
size_bytes integer (int64) 是 File size in bytes

AttemptItem

字段 类型 必填 说明
assignee_id string (uuid) 是 Assignee member UUID
attempt_number integer (int32) 是 Attempt number
blocked_at string (date-time) Blocked time
blocked_on_approval_request_ids array of string (uuid) Blocked approval request UUIDs
created_at string (date-time) 是 Creation time
execution_trace_id string Execution trace ID
failure_reason string Failure reason
finished_at string (date-time) Finish time
id string (uuid) 是 Attempt UUID
started_at string (date-time) Start time
status string: running, done, failed, blocked, cancelled 是 Attempt status
task_id string (uuid) 是 Task UUID
updated_at string (date-time) 是 Last update time

AuthorizeConnectAgentRequestBody

字段 类型 必填 说明
actor_member_id string Optional acting member UUID. The actor is always the authenticated caller: if provided it must equal the caller's member UUID (case-insensitive), otherwise the request is rejected with 403 AUTH_FORBIDDEN. Omit to use the caller.
agent_member_id string (uuid) 是 Agent member UUID
confirm boolean Set true to authorize an agent whose runtime version is unknown (acknowledges the CONNECT_AGENT_VERSION_UNCONFIRMED prompt). Ignored for agents whose version is known — a too-old version is always rejected.

AutoTopupSettingsDTO

字段 类型 必填 说明
card_brand string 是 Display card brand of the pinned credential (e.g. visa); together with card_last4 it forms a line such as "VISA ···· 4242". May be empty: Alipay has no card brand, and a revoked credential can no longer be read. When empty, show only payment_method_type instead of an empty card number
card_last4 string 是 Last four digits of the pinned credential. May be empty; handle it like an empty card_brand
configured boolean 是 Whether auto top-up has ever been configured. false: never configured, and the fields above are meaningless. Once true, the fields above keep the user's last saved values even after auto top-up is turned off (enabled=false)
credential_id string 是 ID of the payment credential pinned when auto top-up was enabled; it decides which payment method is charged. Meaningless when configured=false
enabled boolean 是 Whether auto top-up is turned on. While it is off the other fields keep the last saved configuration, so a client can show it again; turning it off does not erase it
feature_enabled boolean 是 Whether this deployment offers auto top-up (a global feature flag, off by default). When false, hide the whole section rather than showing a switch that cannot be changed; an existing configuration is still returned while the flag is off
month_used_points integer (int64) 是 Credits auto top-up has added this month, shown with monthly_cap_points as "X / Y this month". Counts only successful top-ups; the month boundary is UTC (the same boundary the monthly cap is checked against; showing it in a local time zone would be off by a few hours, so the page could say a top-up is still possible while the charge is refused for exceeding the cap). It is usage, not configuration, so it does not depend on configured. Only GET carries the real value; the PUT response always has 0, so refetch after a successful write
monthly_cap_points integer (int64) 是 Cap on the credits auto top-up may add in one calendar month. At least 1: a cap of 0 would be an enabled setting that never tops up. Meaningless when configured=false
paused boolean 是 Whether auto top-up is currently paused: the last top-up ran through all its retries and still failed, so no further charge is attempted however low the balance gets. enabled stays true (the user did not turn it off; the system stopped), so render the two fields separately. Either of two things resumes it: the balance rising back above the threshold through a credited payment (a manual credit-pack purchase, a payment callback credit, or a support adjustment; refunds and reversals raise the balance but do NOT resume it), or the user saving an enabled configuration again. User-facing text must mention both ways. It is state the user cannot change, not configuration, so it does not depend on configured. Only GET carries the real value; the PUT response is always false
paused_reason string 是 Why auto top-up is paused: the raw failure code of the final failed attempt. It is a code, not display text: map it to your own localized message and never show it to users as is. May be empty even when paused=true, so have a generic fallback message (such as "the last top-up failed"). Never read an empty reason as not paused: only paused says whether it is paused. The PUT response always has an empty string
payment_method_type string 是 Method type of the pinned credential: card or alipay. wechat does not support off-session charges and is refused when configuring. Meaningless when configured=false
sku_code string 是 The credit-pack SKU bought when a top-up triggers. Meaningless when configured=false
threshold_points integer (int64) 是 A top-up is triggered when the balance drops strictly below this value. At least 1: under a strict less-than check 0 would never trigger (the balance is never negative); use 1 for "top up only when the balance reaches zero". Meaningless when configured=false

AutomationArtifactItem

字段 类型 必填 说明
title string 是
url string 是

AutomationAuthorizationPlan

字段 类型 必填 说明
configuration AutomationCreationConfiguration 是
expected_version integer (int64)
operation string: create, update 是
source_kind string: timer, webhook 是
target_binding_id string (uuid)

AutomationAuthorizationPreview

字段 类型 必填 说明
proposal_text string 是

AutomationCreationConfiguration

字段 类型 必填 说明
anchor_at string (date-time)
cron_expr string
event_filter string
interval_seconds integer (int64)
lead_member_id string (uuid) 是
owner_member_id string (uuid) 是
project_member_additions array of string Members added to spec.project_id together with the confirmed write: only lead_member_id and/or owner_member_id, each once, lead first. Omitted or empty when both are already members; always empty for the Inbox
result_notification_policy string: every, failure_only, none Result DM policy; omitted creates use source default, omitted updates preserve the existing policy and migration notice. HTTP null is tolerated as omission
run_at string (date-time)
schedule_kind string: cron, once, interval
spec AutomationCreationSpec 是
timezone string

AutomationCreationEligibility

字段 类型 必填 说明
checked_at string (date-time) 是
current_version string
member_id string 是
minimum_version string
reason string 是
reported_at string (date-time)
status string 是

AutomationCreationPayload

字段 类型 必填 说明
configuration AutomationCreationConfiguration 是
form_context object 是
kind string: automation-create-request 是
lead_member_id string (uuid) 是
org_id string (uuid) 是
request_id string (uuid) 是
requester_member_id string (uuid) 是
schema_version integer (int64) 是
source_kind string: timer, webhook 是

AutomationCreationSpec

字段 类型 必填 说明
description string
knowledge_base_id string (uuid) Knowledge base of the runs; required exactly for knowledge_base_mode custom
knowledge_base_mode string: project_default, custom, none Where runs store their outputs: the project's knowledge base, knowledge_base_id, or none. Omitted: project_default on a create; an update keeps the current choice
project_id string (uuid) Project the run Issues belong to; required unless unattached. An unattached automation may name the system project an earlier read returned
title string 是
unattached boolean The automation belongs to no project: it runs in the organization Inbox or, for a private one, in the Owner's hidden private project. Omitted: attached on a create; an update keeps the current attachment
unattached_scope string: org, private With unattached and no project_id: org (default) or private

AutomationDeliveryItem

字段 类型 必填 说明
artifacts array of AutomationArtifactItem 是
conversation_id string
id string 是
message_id string
notification_status string: pending, sent, suppressed 是 suppressed means this result is retained but its run policy intentionally prevents a DM; it is not a retryable delivery failure
outcome string: success, partial, failed 是
summary string 是

AutomationHandoffRequestBody

字段 类型 必填 说明
intro string 是
request AutomationCreationPayload 是

AutomationHandoffResult

字段 类型 必填 说明
conversation_id string 是
message_id string 是
request_id string 是

AutomationProposalRequest

字段 类型 必填 说明
configuration AutomationCreationConfiguration 是
expected_version integer (int64)
operation string: create, update 是
replaces_proposal_message_id string
request_id string (uuid) 是
requester_member_id string (uuid)
source_kind string: timer, webhook 是
target_binding_id string (uuid)

AutomationProposalResponse

字段 类型 必填 说明
authorization_kind string 是
cancel_action_id string 是
confirm_action_id string 是
conversation_id string 是
modify_action_id string 是
proposal_message_id string 是
proposal_text string 是

AutomationProposalStatus

字段 类型 必填 说明
authorization_kind string 是
card_interaction_id string
expires_at string (date-time) 是
proposal_message_id string 是
status string 是

AutomationUpdateHandoffRequestBody

字段 类型 必填 说明
intro string 是
request AutomationUpdatePayload 是

AutomationUpdatePayload

字段 类型 必填 说明
configuration AutomationCreationConfiguration 是
expected_version integer (int64) 是
form_context object 是
kind string: automation-update-request 是
lead_member_id string (uuid) 是
org_id string (uuid) 是
request_id string (uuid) 是
requester_member_id string (uuid) 是
schema_version integer (int64) 是
source_kind string: timer, webhook 是
target_binding_id string (uuid) 是

AvatarUploadFinalized

字段 类型 必填 说明
artifact_id string (uuid) 是 Active avatar artifact UUID
avatar_url string 是 Long-lived avatar URL to save as avatar_url (PATCH /api/v1/me or PUT /api/v1/agents/{member_id}/avatar)

AvatarUploadPrepared

字段 类型 必填 说明
artifact_id string (uuid) 是 Avatar artifact UUID
expires_at string (date-time) 是 Presigned PUT expiration time
headers object 是 Headers required on the presigned PUT
session_id string (uuid) 是 Upload-session UUID
upload_url string 是 Presigned PUT URL for the image bytes

BalanceAlertSettingsDTO

字段 类型 必填 说明
has_threshold boolean 是 false: no absolute threshold has been set; only the burn-rate based 7 / 3 / 1-day warnings apply
low_balance_points integer (int64) 是 Alert when the balance drops to this many credits or fewer. Meaningless when has_threshold=false

BatchAddConversationMembersRequestBody

字段 类型 必填 说明
member_ids array of string 是 OrgMember/Participant UUIDs to add
role string: UNSPECIFIED, MEMBER, ADMIN, OWNER, PUBLISHER, SUBSCRIBER Role applied to every added member

BatchAgentDMEligibilityRequestBody

字段 类型 必填 说明
agent_member_ids array of string 是 Agent member UUIDs to check, at most 100. Every id must be a well-formed UUID (otherwise the whole batch is rejected with 422). Duplicates are collapsed; [] returns no items.

BatchAgentDMEligibilityResult

字段 类型 必填 说明
items array of AgentDMEligibilityItem 是 One item per distinct requested id, in the order of first appearance in the request

BatchAuthorizeConnectAgentsRequestBody

字段 类型 必填 说明
actor_member_id string Optional acting member UUID. The actor is always the authenticated caller: if provided it must equal the caller's member UUID (case-insensitive), otherwise the request is rejected with 403 AUTH_FORBIDDEN. Omit to use the caller.
agent_member_ids array of string (uuid) 是 Agent member UUIDs to authorize, 1..50 as sent. Duplicates are collapsed (first occurrence keeps its position). An empty list, more than 50 ids or a malformed UUID rejects the whole request with 400.
confirm boolean Set true to authorize agents whose runtime version is unknown (acknowledges CONNECT_AGENT_VERSION_UNCONFIRMED). Applies to every agent of the request; resubmit only the unconfirmed agents with it. A too-old version is always rejected.

BatchGetFileDownloadRequestBody

字段 类型 必填 说明
inline boolean 是 Request inline content disposition
node_ids array of string 是 Tree node UUIDs

BatchGetMessagesRequestBody

字段 类型 必填 说明
message_ids array of string 是 IDs of messages in this conversation to fetch, at most 100 (message ids are int64, carried as decimal strings)

BatchGetMessagesResult

字段 类型 必填 说明
deferred_ids array of string 是 Requested ids not returned because of the per-response card cap; ask for them again
head_change_seq integer (int64) 是 The conversation's change-log head as of these items
items array of MessageItem 是 Current version of the found messages, ascending by seq, with the same enrichment and card trimming as list-messages; a recalled message comes back as its tombstone
missing_ids array of string 是 Requested ids that were silently deleted, hard deleted, or are not in this conversation

BatchMemberDisplayInfoRequestBody

字段 类型 必填 说明
member_ids array of string 是 Member UUIDs to resolve. Every id must be a well-formed UUID (otherwise the whole batch is rejected with 422). Well-formed ids outside the caller's organization, or never known, are omitted from the result rather than failing the batch.

BatchMemberDisplayInfoResponseBody

字段 类型 必填 说明
members array of MemberDisplayInfo 是 Resolved members, in no particular order. Missing ids were not found in the caller's organization.
request_id string 是
server_time string (date-time) 是

BatchRemoveConversationMembersRequestBody

字段 类型 必填 说明
member_ids array of string 是 OrgMember/Participant UUIDs to remove

BatchRemoveMembersRequestBody

字段 类型 必填 说明
member_ids array of string 是 Member UUIDs to remove

BatchRemoveMembersResponseBody

字段 类型 必填 说明
results array of MemberBatchResult 是 Outcome per executed member, in request order; blank and duplicate ids are not represented here
summary MemberBatchSummary 是 Batch outcome counts

BillingCapabilitiesData

字段 类型 必填 说明
auto_renew_disabled boolean 是 true ⇒ this deployment never auto-renews a subscription: no recurring charge is attempted at period end, and clients must not present auto-renew as on, nor offer to turn it on. false or absent ⇒ international behaviour (subscriptions auto-renew). It is also enforced server-side: the payment method is downgraded to a non-recurring tier, every write of a subscription's auto_renew is forced off, and no renewal charge is attempted.
auto_topup_disabled boolean 是 true ⇒ automatic credit top-up is not offered: hide the whole auto top-up section. false or absent ⇒ international behaviour (the section is shown unless the setting below hides it). Hide the auto top-up section when this bit is true OR when feature_enabled from GET /api/v1/billing/auto-topup-settings is false; never rely on only one of the two.
balance_alerts_locked boolean 是 true ⇒ balance alert thresholds are fixed by the deployment: render them read-only rather than as editable settings. false or absent ⇒ international behaviour (user-editable alerts). NOT display-only: billing refuses writes to the alert threshold while this bit is true (reads stay open). The China-edition value is false since 2026-09-16.
card_payment_disabled boolean 是 true ⇒ credit-card payment is not offered; a card payment_method is refused server-side. false or absent ⇒ international behaviour (card offered). Unlike most bits here this one is also enforced by the server (a card payment method is refused when it is classified, set up or saved), so it is a guarantee and not only a request to the client. Do not treat a 401/404 on this endpoint as license to offer card.
checkout_result_binary boolean 是 true ⇒ render the checkout outcome as two states only (succeeded / failed), collapsing every intermediate 'processing/pending' presentation into failed-and-retryable. false or absent ⇒ international behaviour (the full multi-state outcome, including pending).
credit_pack_metered boolean 是 true ⇒ credit packs are sold as a metered quantity (choose an amount at a fixed unit price) instead of fixed-size SKUs. false or absent ⇒ international behaviour (fixed SKUs). It is also enforced server-side (credit-pack quote and submit, and the idempotency fingerprint).
enterprise_contact_sales_only boolean 是 true ⇒ the enterprise tier is contact-sales only: show a contact card instead of a purchasable price, and never route it into checkout. false or absent ⇒ international behaviour (enterprise handled like the other tiers). The China-edition value is provisional and may change.
installment_view_enabled boolean 是 true ⇒ show the per-instalment / grant-schedule view of a multi-period purchase. false or absent ⇒ international behaviour (no instalment view). Additive bit. The schedule data this view renders is not available yet, so a client that turns the view on has nothing to show.
invoice_entry_enabled boolean 是 true ⇒ show the invoice request entry. false or absent ⇒ international behaviour (no invoice entry). Additive bit; a client should not enable the entry before the invoice flow it points at exists.
plan_change_disabled boolean 是 true ⇒ mid-cycle plan change (upgrade/downgrade with proration) is not offered: clients hide the change-plan entry and the proration quote. false or absent ⇒ international behaviour (plan change offered). It is also refused server-side, on both the quote and the submit path.
plan_status_badge_expiry_states boolean 是 true ⇒ the plan status badge uses the expiry-oriented state set (expiring soon / expired) that only makes sense when renewal is manual. false or absent ⇒ international behaviour (the auto-renew-oriented state set). Display-only.
refund_disabled boolean 是 true ⇒ no self-service refund surface: clients hide any refund entry and any copy promising one. false or absent ⇒ international behaviour. Enforced today by the refund route not existing at all; this bit exists so a client does not have to infer that from a 404.
renewal_entry_enabled boolean 是 true ⇒ show the MANUAL renewal entry (the China edition needs it precisely because auto_renew_disabled is also true, so renewal has to be a user action). false or absent ⇒ international behaviour: no manual renewal entry, renewal happens automatically. Additive bit — false is the international default, not a disabled feature.
terms_acceptance_required boolean 是 true ⇒ the client must obtain explicit terms acceptance before submitting a purchase. false or absent ⇒ international behaviour (no separate acceptance step). ⚠ There is NO server-side gate behind this bit: nothing persists an accepted terms version, so a client can bypass it by removing a disabled attribute. Treat it as a UI requirement, not as compliance evidence.
upgrade_badge_hidden boolean 是 true ⇒ suppress the promotional upgrade badge/nudge on plan cards. false or absent ⇒ international behaviour (badge shown). Display-only.

BillingPageListResponseAddonHistoryDTOBody

字段 类型 必填 说明
data array of AddonHistoryDTO 是 Response payload
pagination BillingPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

BillingPageListResponseCreditGrantDTOBody

字段 类型 必填 说明
data array of CreditGrantDTO 是 Response payload
pagination BillingPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

BillingPageListResponseInvoiceApplicationDTOBody

字段 类型 必填 说明
data array of InvoiceApplicationDTO 是 Response payload
pagination BillingPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

BillingPageMetadata

字段 类型 必填 说明
has_more boolean 是 Whether another page exists; fetch it by incrementing page with the same page_size
page integer (int32) 是 Page number that produced this data (1-based)
page_size integer (int32) 是 Effective page size (server default 50 when omitted)

BillingPaymentOptionDTO

字段 类型 必填 说明
enabled boolean 是 Whether this method may be offered and submitted for this scenario; disabled entries are returned so clients can distinguish 'withheld' from 'unknown'
id string 是 Payment method wire value, submitted as payment_method (card|wechat|alipay)
sort integer (int64) 是 Display order, ascending

BillingPaymentOptionsData

字段 类型 必填 说明
options array of BillingPaymentOptionDTO 是 Configured payment methods for this scenario, ordered by sort
scenario string 是 Echo of the requested scenario

BindAgentChannelRequestBody

字段 类型 必填 说明
config object 是 Channel form values keyed by field key. Sensitive values are forwarded to the agent runtime and are never persisted or logged by the platform.

BlueprintItem

字段 类型 必填 说明
approval_request_id string (uuid) Approval request UUID
approved_at string (date-time) Approval time
author_agent_id string (uuid) 是 Author agent UUID
content_hash string 是 Blueprint content hash
created_at string (date-time) 是 Creation time
estimated_budget object Estimated budget JSON object
id string (uuid) 是 Blueprint UUID
issue_id string (uuid) 是 Issue UUID
notes string 是 Blueprint notes
status string: draft, approved, rejected, superseded 是 Blueprint status
steps array of BlueprintStepItem Blueprint steps
superseded_at string (date-time) Superseded time
updated_at string (date-time) 是 Last update time
version_number integer (int32) 是 Blueprint version number

BlueprintStepItem

字段 类型 必填 说明
blueprint_id string (uuid) 是 Blueprint UUID
created_at string (date-time) 是 Creation time
depends_on array of string Dependency step UUIDs
description string 是 Step description
id string (uuid) 是 Blueprint step UUID
required_resources object Required resources JSON object
sort_order integer (int32) 是 Step sort order
updated_at string (date-time) 是 Last update time

BridgeDetailItem

字段 类型 必填 说明
last_sync_at string (date-time) 是 Last sync time
platform string 是 Bridge platform
status string 是 Bridge status

BroadcastDetailItem

字段 类型 必填 说明
publisher_count integer (int32) 是 Publisher count
subscriber_count integer (int32) 是 Subscriber count

CancelApprovalRequestBody

字段 类型 必填 说明
reason string Cancellation reason

CapabilityTagDTO

字段 类型 必填 说明
kind string: curated, freeform 是 curated = controlled vocabulary key (hard filter, i18n via key); freeform = free text (soft ranking only, not translated)
note string Optional free-text nuance
tag string 是 For curated: a stable, language-independent vocabulary key (see the published capability-tag vocabulary; the client localizes the key for display). For freeform: free text.

CapabilityTagInputDTO

字段 类型 必填 说明
kind string: curated, freeform 是 curated = controlled vocabulary key (hard filter, i18n via key); freeform = free text (soft ranking only, not translated)
note string Optional free-text nuance
tag string 是 For curated: a stable vocabulary key from the published capability-tag vocabulary (rejected with MEMBER_CAPABILITY_TAG_INVALID if unknown). For freeform: free text.

CapabilityTagVocabularyData

字段 类型 必填 说明
items array of CapabilityTagVocabularyItemDTO 是 Ordered curated capability-tag options

CapabilityTagVocabularyItemDTO

字段 类型 必填 说明
deprecated boolean Whether this option should be hidden for new selections
key string 是 Stable language-independent curated capability-tag key submitted in API payloads
labels object Localized display labels keyed by locale, for example zh or en

CardActionSubmitInput

字段 类型 必填 说明
action_id string 是 Card-local id of the clicked action; must be a kind=operation action

CardChoiceResult

字段 类型 必填 说明
card_sender CardIdentityItem Sender of the card that was answered
change_seq integer (int64) 是 Conversation change_seq the settlement allocated, so the acting device can advance its change watermark. 0 on a replay, which records nothing new.
interaction_id string 是 Interaction record ID
replayed boolean 是 True when this card had already been answered and this request did not change it. The first answer stands; this is not an error — selected_action_ids carries the answer that won.
result_at string (date-time) 是 When the settled answer was recorded. On a replay this is the first answer's instant, not this request's.
selected_action_ids array of string Card-local ids of the options that were SETTLED, read back from the stored answer. On a replay these are the winning first answer, NOT the ids sent in this request.
status string 是 Always succeeded: a record exists only for an answer that was accepted

CardChoiceSubmitInput

字段 类型 必填 说明
selected_action_ids array of string 是 Card-local ids of the chosen options. For selection_mode=single this is exactly one id.
selection_mode string 是 How many options the card accepts. The protocol reserves 'multiple'; the platform serves only 'single' today and fails closed on anything else.

CardFormAnswerInput

字段 类型 必填 说明
other_text string Present, even as an empty string, when the other choice is ticked; absent when it is not. A blank one ticks other without counting the question as answered.
selected_option_ids array of string Choice questions only: option ids of this question that were chosen. On a single question the options and other together take exactly one choice, so with other ticked this is empty.
text string Text questions only: the typed answer. The platform trims it; blank counts as not answered. Nothing is truncated: too long or too short is refused.

CardFormAnswerItem

字段 类型 必填 说明
other_text string Present when the other choice was ticked, as an empty string when it was ticked with no details; absent when it was not ticked
selected_option_ids array of string 是 Option ids from the card, in the card's order
text string Answer to a text question as the platform stored it (trimmed); absent on a choice question

CardFormSubmitInput

字段 类型 必填 说明
answers object 是 Answers keyed by question key, holding only the questions the answerer chose something on

CardIdentityItem

字段 类型 必填 说明
kind string 是 human_member | agent_member | system_member
member_id string 是 Member UUID

CardInteractionAuditItem

字段 类型 必填 说明
action_id string 是 Card-local id of the clicked action
actor_id string (uuid) 是 Member UUID that clicked
actor_type string 是 Always human: the recorded actor is the person who clicked
confirmed_at string (date-time) 是 When the platform persisted the record
content_version integer (int32) 是 The card's content version at resolve time, frozen so the record still proves what was clicked after a recall purges the body
correlation_id string Opaque key the caller supplied at click time; absent when none was sent
form_answers object Submitted answer of a form-card interaction, keyed by question key; absent on every other interaction
interaction_id string 是 Interaction record ID
operation string 是 Registry operation the click dispatched to
result_at string (date-time) 是 When the business took effect, read out of the business response
status string 是 Always succeeded: a failed business call records no interaction

CardInteractionResult

字段 类型 必填 说明
action_id string 是 Card-local action id that was clicked
card_sender CardIdentityItem Sender of the card the action belongs to
change_seq integer (int64) 是 Conversation change_seq the settlement allocated, so the acting device can advance its change watermark. 0 on a replay, which records nothing new.
interaction_id string 是 Interaction record ID
replayed boolean 是 True when the same idempotency key already had an interaction record
result_at string (date-time) 是 When the business took effect, read out of the business response
status string 是 Always succeeded: a record exists only for an effect that happened

CardInteractionSubmitResult

字段 类型 必填 说明
action_id string Action only: the card-local action id that was clicked
actor_id string (uuid) Form only: the member who submitted the stored answer. On a replay this tells the caller's own earlier submit apart from someone else's.
answers object Form only: the settled answers keyed by question key. On a replay these are the winning first submit, not this request's.
card_sender CardIdentityItem Sender of the card
change_seq integer (int64) 是 Conversation change_seq the record allocated, so the acting device can advance its change watermark. 0 on a replay, which records nothing new.
interaction_id string 是 Interaction record ID
interaction_type string: choice, form, action 是 Echo of the request's interaction_type
replayed boolean 是 True when this request did not record anything new: a retry under the same key, or a choice or form card that had already been answered. The first answer stands; this is not an error.
result_at string (date-time) 是 When the recorded interaction took effect. On a replay this is the first record's instant.
selected_action_ids array of string Choice only: the settled option ids. On a replay these are the winning first answer, not the ids sent in this request.
status string 是 Always succeeded: a record exists only for an accepted answer or an effect that happened

CardStateItem

字段 类型 必填 说明
action_id string 是 Card-local id of the action that was clicked
actor_id string (uuid) 是 Member UUID that clicked
form_answers object Settled answer of a form card (kind interaction.form), keyed by question key, holding only the questions the answerer chose something on. Absent on every other card.
result_at string (date-time) 是 Click instant, not the instant the server persisted it
status string 是 Interaction status; always succeeded in v1.0

CatalogAgentTierDTO

字段 类型 必填 说明
code string 是 agent_standard|agent_advanced
name string 是
provision_spec AgentProvisionDTO
retainer_points_month integer (int64) 是
runtime_billing_enabled boolean 是
runtime_rate AgentRuntimeRateDTO
tier string 是 standard|advanced
usage_points_day integer (int64) 是

CatalogCreditPackDTO

字段 类型 必填 说明
code string 是
name string 是
points integer (int64) 是
prices array of CatalogPriceDTO 是
validity_days integer (int32) 是

CatalogDTO

字段 类型 必填 说明
agent_tiers array of CatalogAgentTierDTO 是
credit_packs array of CatalogCreditPackDTO 是
plans array of CatalogPlanDTO 是

CatalogPlanDTO

字段 类型 必填 说明
allow_self_purchase boolean 是 Whether subscribers to this custom plan may purchase credit packs themselves
allowed_renewal_modes array of string 是 Renewal modes allowed by plan policy: psp|admin_managed
custom_plan boolean 是
entitlements EntitlementsDTO
name string 是
plan_code string 是
plan_family string 是 personal|team; authoritative catalog grouping
plan_version integer (int32) 是
prices array of CatalogPriceDTO 是

CatalogPriceDTO

字段 类型 必填 说明
billing_interval string 是
currency string 是
list_unit_amount_cents integer (int64) 是 Display-only list price in minor units; never used for charging
price_id string 是
unit_amount_cents integer (int64) 是 Minor units (cents); durable charged and renewal price

ChangeEventBindingStateRequestBody

字段 类型 必填 说明
expected_version integer (int64) 是 Current binding version for optimistic concurrency control

ChannelConfirmationStatus

字段 类型 必填 说明
status string 是

CheckoutHandleDTO

字段 类型 必填 说明
checkout_type string redirect (default; empty means redirect) | qr_code (checkout_url is QR content, render it) | jsapi (checkout_url is JSAPI params, do not navigate)
checkout_url string
payment_order_id string

ChoiceConfirmInput

字段 类型 必填 说明
label string Confirm button text. Optional; the platform omits the key when empty.
text string 是 Confirmation prompt shown before the answer is submitted

ChoiceInteractionInput

字段 类型 必填 说明
blocks array of object 是 Card body blocks. The platform enforces the permitted block types and fails closed on any other.
confirm ChoiceConfirmInput Default confirmation step, applied to every option that declares none of its own. A mixed card should set confirm per option instead.
kind string Card family: interaction.choice (the default), onboarding.task, onboarding.channel or onboarding.partner. The platform holds the accepted set and refuses anything else.
options array of ChoiceOptionInput 是 The choices offered. The platform caps how many and rejects duplicate option text.
summary string One-line summary, also the plain-text projection for clients that cannot render the card. Optional: the platform holds which kinds may omit it and refuses the rest. May be omitted or empty; an explicit null is refused.
title string 是 Card title

ChoiceOptionInput

字段 类型 必填 说明
behavior string What a click does: answer (the default) or open_create_agent. The platform holds the accepted set and which kinds admit each.
confirm ChoiceConfirmInput Confirmation step for this option only. Overrides the card-level confirm; omit to inherit it.
decline boolean Marks the option meaning none of these. The platform records its generated id in the card's context.extra.decline_action_id.
icon string Icon slug for the client to resolve; never a URL. The platform checks the charset and which kinds admit it.
label string 是 Button text. The platform caps the length and rejects two options whose text matches after trim+NFC.
style string Visual emphasis. The platform holds the accepted set and refuses anything else.

ClaimConnectShopifyAppInstallRequestBody

字段 类型 必填 说明
display_name string Optional connection display name; defaults to "Shopify · "
ticket string 是 One-time claim ticket from the claim page URL (/connect/shopify/claim?ticket=...)

CompleteConnectReauthRequestBody

字段 类型 必填 说明
code string 是 OAuth code
raw_params object Verbatim reauth OAuth callback query parameters
state string 是 OAuth state

ConfirmChannelConnectionRequestBody

字段 类型 必填 说明
agent_member_id string (uuid) 是
channel_type string: feishu, lark, dingtalk, wecom 是
conversation_id string (uuid) 是

ConnectActionItem

字段 类型 必填 说明
action string 是
auth_header_name string
description string 是
encoding string
headers_template object
input_schema string 是
method string 是
params array of string 是
request_spec any
toolkit string 是
url_template string

ConnectAgentBatchAuthorizeData

字段 类型 必填 说明
results array of ConnectAgentBatchAuthorizeOk | ConnectAgentBatchAuthorizeFailure 是 One result per requested agent after de-duplication, in request order.
summary ConnectAgentBatchAuthorizeSummary 是 Counts of results by status.

ConnectAgentBatchAuthorizeError

字段 类型 必填 说明
code string: MEMBER_NOT_FOUND, MEMBER_NOT_AN_AGENT, CONNECT_AGENT_TYPE_NOT_ALLOWED, CONNECT_AGENT_VERSION_TOO_OLD, CONNECT_AGENT_VERSION_UNCONFIRMED 是 MEMBER_NOT_FOUND: unknown id, a member of another org, removed or departed (not distinguished). MEMBER_NOT_AN_AGENT: a current org member that is not an agent. CONNECT_AGENT_TYPE_NOT_ALLOWED: an external-invited agent whose runtime type cannot be authorized onto a connection (only the platform's default agent runtime can). CONNECT_AGENT_VERSION_TOO_OLD: runtime version below the minimum (hard block, meta version + minVersion). CONNECT_AGENT_VERSION_UNCONFIRMED: no reported runtime version and confirm was false (meta minVersion).
message string 是 Human-readable explanation
meta object Structured values for localization: version / minVersion on the version errors; absent otherwise.

ConnectAgentBatchAuthorizeFailure

字段 类型 必填 说明
agent_member_id string (uuid) 是 Agent member UUID, as requested (canonical lowercase form)
error ConnectAgentBatchAuthorizeError 是 Why this agent was not authorized.
status string: failed 是 The agent was not authorized.

ConnectAgentBatchAuthorizeOk

字段 类型 必填 说明
agent_member_id string (uuid) 是 Agent member UUID, as requested (canonical lowercase form)
authorized_at string (date-time) When the new grant was created; present only for authorized.
status string: authorized, already_authorized 是 authorized: a new grant was created by this request. already_authorized: the agent already held a grant on the connection (counts as success; safe to retry).

ConnectAgentBatchAuthorizeSummary

字段 类型 必填 说明
already_authorized integer (int64) 是 Agents that already held a grant
authorized integer (int64) 是 Agents newly authorized by this request
failed integer (int64) 是 Agents not authorized (see their error)

ConnectAgentChannelRequestBody

字段 类型 必填 说明
config object 是 Channel form values keyed by field key. Sensitive values are forwarded to the agent runtime and are never persisted or logged by the platform.

ConnectAgentItem

字段 类型 必填 说明
agent_member_id string 是
application_id string 是
connection_id string 是
created_at string (date-time)
id string 是

ConnectAgentUsableConnectionApplication

字段 类型 必填 说明
icon_url string 是 Application icon URL; empty when unset
id string 是 Application UUID
name string 是 Application display name
slug string 是 Application key, e.g. gitlab, google-drive

ConnectAgentUsableConnectionItem

字段 类型 必填 说明
application ConnectAgentUsableConnectionApplication 是 The connection's application
authorized_at string (date-time) 是 When the agent was authorized on this connection
display_name string 是 Connection display name
id string 是 Connection UUID
needs_reauth boolean 是 status is error AND a pending re-authorization request exists (the owner must re-authorize)
owner_member_id string 是 Member who owns the connection (send re-authorization to them)
owner_scope string 是 org | personal
status string 是 pending | active | error | expired | revoked — same vocabulary as list-connect-connections; only active is usable now

ConnectAgentUsableConnectionsError

字段 类型 必填 说明
code string: MEMBER_NOT_FOUND, MEMBER_NOT_AN_AGENT, FORBIDDEN 是 MEMBER_NOT_FOUND: unknown id, a member of another org, removed or departed (not distinguished). MEMBER_NOT_AN_AGENT: a current (non-departed, including suspended) org member that is not an agent. FORBIDDEN: the caller may not read this agent's connections.
message string 是 Human-readable explanation

ConnectAgentUsableConnectionsFailure

字段 类型 必填 说明
agent_member_id string (uuid) 是 Agent member UUID, as requested (canonical lowercase form)
error ConnectAgentUsableConnectionsError 是 Why this agent could not be read.

ConnectAgentUsableConnectionsOk

字段 类型 必填 说明
agent_member_id string (uuid) 是 Agent member UUID, as requested (canonical lowercase form)
connections array of ConnectAgentUsableConnectionItem 是 The agent's usable connections matching statuses (possibly []), most recently authorized first.

ConnectApplicationActionDefItem

字段 类型 必填 说明
application_id string 是
created_at string (date-time)
description string 是
encoding string 是
headers object
id string 是
input_schema string 是
method string 是
name string 是
request_spec any
updated_at string (date-time)
url_template string 是

ConnectApplicationCategoryCount

字段 类型 必填 说明
category string 是 Application category
count integer (int64) 是 Number of applications in this category

ConnectApplicationCategoryCounts

字段 类型 必填 说明
categories array of ConnectApplicationCategoryCount 是 Non-empty categories, count descending then category ascending
total_count integer (int64) 是 Sum of categories[].count: the list-connect-applications total_count for the same filters without a category

ConnectApplicationItem

字段 类型 必填 说明
api_key_auth_style string
api_key_header_name string
api_key_location string
category string 是
connection_count integer (int32) 是
connection_state string: none, connected, needs_reauth, expired Per-caller catalog connection state (list and get): connected > needs_reauth > expired > none
connector_kind string
created_at string (date-time)
created_by string
credential_mode string 是
credential_source string
default_ttl_seconds integer (int32) 是
description string 是
display_name string 是
icon_url string 是
id string 是
is_connected boolean 是
is_enabled boolean 是
mcp_template object Connector-level MCP server template (JSON object); omitted when unset
needs_reauth_count integer (int32) 是 Number of counted connections that need re-authorization (list and get)
oauth_authorize_url string 是
oauth_callback_url string
oauth_client_id string
oauth_pkce boolean
oauth_scopes_default array of string 是
oauth_token_auth_method string
oauth_token_body_format string
oauth_token_url string 是
org_id string
provider_type string 是
requires_oauth_client_credentials boolean
requires_oauth_config_id boolean
requires_oauth_instance_host boolean
slug string 是
sort_order integer (int32) 是
source string
tags array of string 是
updated_at string (date-time)
visibility string

ConnectApplicationsQueryError

字段 类型 必填 说明
code string: APPLICATION_NOT_FOUND 是 APPLICATION_NOT_FOUND: unknown id, a deleted application, or another org's private connector (not distinguished).
message string 是 Human-readable explanation

ConnectApplicationsQueryFailure

字段 类型 必填 说明
application_id string (uuid) 是 Application UUID, as requested (canonical lowercase form)
error ConnectApplicationsQueryError 是 Why this application could not be read.

ConnectApplicationsQueryOk

字段 类型 必填 说明
application ConnectApplicationItem 是 The same item get-connect-application returns for this id, including the caller's connection state.
application_id string (uuid) 是 Application UUID, as requested (canonical lowercase form)

ConnectAuthorizedAgentRef

字段 类型 必填 说明
agent_member_id string (uuid) 是 Authorized agent member UUID
authorized_at string (date-time) 是 When the agent was authorized on this connection

ConnectConnectFieldItem

字段 类型 必填 说明
default string 是
description string 是
description_i18n object
display_name string 是
display_name_i18n object
is_secret boolean 是
legacy_template_name string 是
name string 是
placeholder string
placeholder_i18n object
required boolean 是
type string 是
user_visible boolean 是

ConnectConnectFieldsData

字段 类型 必填 说明
application_slug string 是
fields array of ConnectConnectFieldItem 是
toolkit_slug string 是

ConnectConnectionItem

字段 类型 必填 说明
application_id string 是
application_name string 是
application_slug string 是
connected_at string (date-time)
created_at string (date-time)
credential_mode string 是
credential_source string 是
display_name string 是
expires_at string (date-time)
external_identity string 是
id string 是
last_used_at string (date-time)
needs_reauth boolean 是
org_id string 是
owner_member_id string 是
owner_scope string 是
scopes_granted array of string 是
status string 是
ttl_seconds integer (int32) 是
updated_at string (date-time)

ConnectConnectionWithAgentsItem

字段 类型 必填 说明
application_id string 是
application_name string 是
application_slug string 是
authorized_agents array of ConnectAuthorizedAgentRef 是 Live agents authorized on this connection, most recently authorized first. Deleted and departed agent members are omitted. Possibly empty, never null.
connected_at string (date-time)
created_at string (date-time)
credential_mode string 是
credential_source string 是
display_name string 是
expires_at string (date-time)
external_identity string 是
id string 是
last_used_at string (date-time)
needs_reauth boolean 是
org_id string 是
owner_member_id string 是
owner_scope string 是
scopes_granted array of string 是
status string 是
ttl_seconds integer (int32) 是
updated_at string (date-time)

ConnectCreateConnectionData

字段 类型 必填 说明
connection ConnectConnectionItem 是
discovery_status string 是
redirect_url string 是

ConnectCreateConnectionMcpServerInput

字段 类型 必填 说明
args array of string Argument vector for the stdio command
auth_type string MCP auth type: none (default), bearer, or oauth. A stdio server accepts only none — its secrets live inline in raw_config env; stdio with any other auth_type (or with an api_key on the api-key path) is rejected with 400.
command string Local executable to spawn (stdio transport)
env array of ConnectMcpEnvInput Structured per-env-var copy of a stdio MCP server's environment: each {name, value, is_secret}. stdio only; names non-empty and unique (case-sensitive); is_secret=true requires a non-empty value and envelope-encrypts it at rest. A redaction copy only — raw_config remains the launch source and env is never returned. Validated server-side.
headers array of ConnectMcpHeaderInput Structured per-header custom headers for a remote_http MCP server: each {name, value, is_secret}. is_secret=true (remote_http only) envelope-encrypts the value at rest; validated server-side. Supersedes headers_template when non-empty.
headers_template object Non-secret HTTP headers to send to the MCP server, as a name→value map
raw_config any Complete canonical MCP server JSON (single server object or single-entry {"mcpServers":{...}} wrapper), forwarded verbatim. REQUIRED for every new MCP connection and must be launchable on its own (stdio: non-empty command; remote_http: non-empty url; declared transport must match), else 400. It is the sole launch source and carries secrets as their real values; the platform encrypts it as a whole at rest and never returns it except to a bound agent via acquire.
server_url string Remote MCP server URL (remote_http transport)
transport string MCP transport: remote_http (default) or stdio

ConnectCursorListResponseConnectActionItemBody

字段 类型 必填 说明
data array of ConnectActionItem 是 Response payload
next_cursor string Cursor for the next page; omitted when there are no more results
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
total_count integer (int64) Total number of matching applications across all pages; present for paginated requests
total_pages integer (int32) Total number of numbered pages (ceil(total_count/page_size)); present only in numbered mode

ConnectCursorListResponseConnectApplicationItemBody

字段 类型 必填 说明
data array of ConnectApplicationItem 是 Response payload
next_cursor string Cursor for the next page; omitted when there are no more results
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
total_count integer (int64) Total number of matching applications across all pages; present for paginated requests
total_pages integer (int32) Total number of numbered pages (ceil(total_count/page_size)); present only in numbered mode

ConnectExecuteActionData

字段 类型 必填 说明
body any
status_code integer (int32) 是

ConnectInitiateReauthData

字段 类型 必填 说明
reauth_request_id string 是
redirect_url string 是

ConnectMcpEnvInput

字段 类型 必填 说明
is_secret boolean Envelope-encrypt this env value at rest. Supported only for transport=stdio.
name string 是 Env var name (required, non-empty, unique case-sensitively; validated by the platform)
value string Env var value (plaintext on input); required when is_secret=true

ConnectMcpHeaderInput

字段 类型 必填 说明
is_secret boolean Envelope-encrypt this header's value at rest. Supported only for transport=remote_http; the platform rejects is_secret=true on a stdio server.
name string 是 Header name (required, non-empty; validated by the platform)
value string Header value (plaintext on input). On update, an is_secret=true entry with an empty value keeps the existing stored ciphertext for this header name unchanged; a non-empty value (re-)encrypts.

ConnectOAuthCallbackURLData

字段 类型 必填 说明
callback_url string 是

ConnectProxyForwardData

字段 类型 必填 说明
body any
headers object 是
status_code integer (int32) 是

ConnectShopifyAppInstallItem

字段 类型 必填 说明
expires_at string (date-time) When the ticket stops being claimable
shop string 是 The verified, lowercase *.myshopify.com host the ticket was issued for: the shop a claim would connect

ConnectToolkitItem

字段 类型 必填 说明
application_id string 是
config_template any
description string 是
display_name string 是
id string 是
install_command string 是
install_url string 是
mcp_config any
native_command string 是
requires_direct boolean 是
skill_manifest any
slug string 是
tool_type string 是
version string 是

ConversationChangeItem

字段 类型 必填 说明
change_seq integer (int64) 是 Conversation change number
created_at integer (int64) 是 When the change happened (unix ms)
kind string: UNSPECIFIED, EDITED, RECALLED, DELETED, REACTION_ADDED, REACTION_REMOVED, CARD_INTERACTION 是 Kind of the change. A hint only: refetch the message by id with batch-get-messages whatever the kind; the only shortcut is that a DELETED message can be removed locally.
message_id string 是 Changed message ID
message_seq integer (int64) 是 The changed message's seq, so a client can keep only the ids inside the range it holds locally

ConversationChangesResult

字段 类型 必填 说明
changes array of ConversationChangeItem 是 Ascending by change_seq; a message appears at most once per page (its last change in the page). Empty when too_old.
has_more boolean 是 True while next_since_change_seq < head_change_seq
head_change_seq integer (int64) 是 The conversation's change-log head as of these changes
next_since_change_seq integer (int64) 是 The largest change_seq scanned in this page; equals the request's since_change_seq on an empty page. Pass it as the next since_change_seq.
too_old boolean 是 True when the changes after since_change_seq can no longer be listed (cleaned by retention, or since_change_seq is beyond the head). Drop the local segment, refetch the newest window with list-messages and initialize the watermark from its head_change_seq.

ConversationConnectorItem

字段 类型 必填 说明
connector_id string 是
conversation_id string 是
enabled boolean 是

ConversationConnectorList

字段 类型 必填 说明
connectors array of ConversationConnectorItem 是

ConversationItem

字段 类型 必填 说明
agent_collab_participants array of AgentCollabParticipantItem Agent collaboration participants for observed agent DM conversations
archived_at string (date-time) Archived time
archived_reason string: owner, app_uninstalled Why an archived sub-conversation is read-only: owner (its owner archived it) or app_uninstalled (the owning app was uninstalled; a reinstall lifts it). Omitted otherwise.
avatar_url string Avatar URL
bridge BridgeDetailItem Bridge details
broadcast BroadcastDetailItem Broadcast details
can_mention_all boolean 是 Whether the current user can use @all/@all_agents in this conversation. Only populated by get-conversation; list responses always return false.
context_key string The owner's opaque key of this sub-conversation (1-128 characters of [a-z0-9:_-]), unique per (parent, owner).
context_owner_app_id string (uuid) The owning app's app_id when context_owner_kind is app (stable across uninstall and reinstall).
context_owner_kind string: app, platform Who owns this sub-conversation: an app (context_owner_app_id) or the platform (reply topics, context_key message:). Omitted on an ordinary conversation.
context_title string Display title of this sub-conversation, set by its owner.
created_at string (date-time) 是 Creation time
dm DmDetailItem DM details
group GroupDetailItem Group details
id string (uuid) 是 Conversation UUID
is_observer boolean 是 Whether this conversation is visible through observation
last_message_at string (date-time) 是 Last message time
last_message_id integer (int64) Last message ID
last_message_preview LastMessagePreviewItem Last message preview
member_count integer (int32) 是 Member count
name string Conversation name
owner_id string (uuid) Owner member UUID
parent_conversation_id string (uuid) Parent conversation UUID when this is a context sub-conversation; omitted on an ordinary conversation. Not named parent_id, which clients use for the replied-to message.
read_receipt_mode string 是 Caller-perspective read-receipts mode: "full" when delivered/read indicators should render, otherwise "none". Only populated by get-conversation; list responses always return empty (same posture as can_mention_all).
type string: UNSPECIFIED, DM, GROUP, STRAT, BROADCAST, BRIDGE 是 Conversation type: DM, GROUP, STRAT, BROADCAST or BRIDGE; UNSPECIFIED only when the type is unknown.
unread_count integer (int32) 是 Unread message count

ConversationMemberBatchResponse

字段 类型 必填 说明
results array of ConversationMemberBatchResult 是 Per-member operation results
summary ConversationMemberBatchSummary 是 Batch operation summary

ConversationMemberBatchResult

字段 类型 必填 说明
code string Stable error code when this member operation failed
member_id string (uuid) 是 OrgMember/Participant UUID
message string Human-readable error message when this member operation failed
status integer (int64) 是 HTTP-equivalent status for this member operation
success boolean 是 Whether this member operation succeeded

ConversationMemberBatchSummary

字段 类型 必填 说明
duplicates integer (int64) 是 Number of duplicate member IDs skipped before execution
failed integer (int64) 是 Number of failed member operations
invalid integer (int64) 是 Number of invalid member IDs skipped before execution
success integer (int64) 是 Number of successful member operations
total integer (int64) 是 Number of requested member operations
unique_total integer (int64) 是 Number of unique non-empty member IDs processed

ConversationMemberItem

字段 类型 必填 说明
avatar_url string Resolved member avatar URL; omitted when unresolved
display_name string 是 Org member display name, resolved server-side. Empty when the member cannot be resolved in the caller's org (e.g. cross-org or hard-deleted member); clients must render a placeholder rather than the raw UUID.
is_muted boolean 是 Whether the member has muted the conversation
is_pinned boolean 是 Whether the member has pinned the conversation
joined_at string (date-time) 是 Join time
kind string: human, agent Resolved member kind; omitted when unresolved
last_ack_seq integer (int64) 是 Last acknowledged sequence
last_read_seq integer (int64) 是 Last read sequence
member_id string (uuid) 是 OrgMember/Participant UUID
nickname string Member nickname
role string: UNSPECIFIED, MEMBER, ADMIN, OWNER, PUBLISHER, SUBSCRIBER 是 Conversation member role

ConversationResourceItem

字段 类型 必填 说明
artifact_id string Images and files: the artifact to resolve for preview or download
content_type string Images and files: MIME type
conversation_id string (uuid) 是 Conversation the message is in (a sub-conversation's own ID for its messages)
file_name string Images and files: file name
id string 是 Resource ID
kind string: image, file, link 是 Resource kind: image and file carry artifact_id, link carries url
link_text string Links: the link text, when the message gave one
media_id string Images and files: the upload record, when there is one
message_at string (date-time) 是 Time of the message that carries the resource (the sort key)
message_id string 是 ID of the message that carries the resource
message_seq integer (int64) 是 Conversation sequence of that message
root_conversation_id string (uuid) 是 Top-level conversation: conversation_id itself, or the parent of a sub-conversation
sender_id string (uuid) 是 Sender member UUID
sender_type string: UNSPECIFIED, HUMAN, AGENT, SYSTEM 是 Sender type
size_bytes integer (int64) Images and files: size in bytes
url string Links: the normalized URL
url_host string Links: the URL's host

ConversationWorkLinkItem

字段 类型 必填 说明
anchor_message_id string Message the link is anchored to, when there is one
issue IssueItem 是 The linked Issue, as get-issue returns it; status, terminated_at and archived_at tell ended Issues apart
link_id string (uuid) 是 Issue-conversation link UUID
link_role string: origin, discussion, delivery, approval, handoff 是 How the Issue relates to the conversation; origin = created from it
linked_at string (date-time) 是 Link creation time

CreateAppAgentGrantRequestBody

字段 类型 必填 说明
agent_member_id string (uuid) 是 The Agent (member ID) the calling app may act as; the caller must be its owner

CreateApprovalRequestBody

字段 类型 必填 说明
action string Requested action
approver_member_id string (uuid) Approver member UUID
detail any Approval request detail
kind string: resource_grant, external_share 是 Approval request kind
policy_id string (uuid) Approval policy UUID
request_expires_at string (date-time) Request expiry time
request_reason string Request reason
scope_id string (uuid) 是 Scope/resource UUID
scope_type string 是 Scope/resource type

CreateBlueprintRequestBody

字段 类型 必填 说明
estimated_budget object Estimated budget JSON object
notes string Blueprint notes
steps array of StepInput 是 Blueprint steps

CreateConnectAPIKeyConnectionRequestBody

字段 类型 必填 说明
api_key string API key credential (single-value shortcut; optional when the multi-field 'fields' map is used instead)
application_slug string 是 Application slug
base_url string Per-connection base URL (required for applications with no fixed host, e.g. Jenkins)
display_name string Connection display name
fields object Multi-field API key credential values keyed by connect-field name (see the application's connect-fields schema: the provider's field names for provider-hosted api_key toolkits, or api_key/username/base_url for managed api_key connectors); used exactly as sent
mcp_server ConnectCreateConnectionMcpServerInput Per-connection MCP server configuration (connector_kind=mcp, none/bearer auth only; bearer/api_key is remote_http-only — a stdio server must use auth_type=none with no api_key); omit for ordinary api_key and provider-hosted connections
org_id string (uuid) Organization UUID
owner_member_id string (uuid) Owner member UUID
owner_scope string 是 Owner scope
username string Username (required when the application's api_key_auth_style is 'basic', e.g. Jenkins)

CreateConnectApplicationActionDefRequestBody

字段 类型 必填 说明
description string 是 Action description (required, non-empty)
encoding string Request body encoding
headers object Header template
input_schema string JSON schema for action inputs
method string 是 HTTP method
name string 是 Action name
request_spec any Optional request_spec JSON object (direct-mode body template / files / upload / batch). Validated by the platform; encoding must then be empty
url_template string 是 URL template

CreateConnectApplicationRequestBody

字段 类型 必填 说明
api_key_header_name string API key header/param name
api_key_location string API key location: header or query
category string Category
connector_kind string Connector transport kind: http (default) or mcp
default_ttl_seconds integer (int32) Default credential TTL in seconds
description string Description
display_name string 是 Display name
icon_url string Icon URL
oauth_authorize_url string OAuth authorize URL
oauth_client_id string OAuth client ID
oauth_client_secret string OAuth client secret
oauth_pkce boolean Whether OAuth uses PKCE
oauth_scopes_default array of string Default OAuth scopes
oauth_token_auth_method string OAuth token auth method: basic or post
oauth_token_body_format string OAuth token body format: form or json
oauth_token_url string OAuth token URL
provider_type string 是 Provider type
slug string Application slug (optional; generated by OpenMax when omitted)
tags array of string Tags

CreateConnectConnectionRequestBody

字段 类型 必填 说明
application_slug string 是 Application slug
display_name string Connection display name
mcp_server ConnectCreateConnectionMcpServerInput Per-connection MCP server configuration (connector_kind=mcp only); omit for http, provider-hosted and managed connections
oauth_client_id string Per-connection (BYO) OAuth client ID; required only for applications that need per-connection client credentials (e.g. Shopify custom apps)
oauth_client_secret string Per-connection (BYO) OAuth client secret; required only for applications that need per-connection client credentials (e.g. Shopify custom apps). Stored encrypted, never returned in any response.
oauth_config_id string Per-connection Facebook Login for Business configuration ID; required only for applications that declare requires_oauth_config_id (e.g. Meta with your own app). Stored encrypted and not returned in connection records; it appears only as the config_id parameter of the returned redirect_url.
oauth_instance_host string Per-connection OAuth host for per-tenant connectors (e.g. Shopify's {shop}.myshopify.com); required only when the application declares requires_oauth_instance_host
org_id string (uuid) Organization UUID
owner_member_id string (uuid) Owner member UUID
owner_scope string 是 Owner scope

CreateDMSubConversationRequestBody

字段 类型 必填 说明
context_key string 是 As for create-subconversation.
peer_member_id string (uuid) 是 The DM peer (OrgMember/Participant UUID). The caller's main DM with this member is found or created and the sub-conversation hangs under it.
title string Display title. On an existing unarchived sub-conversation it replaces the title.

CreateEventBindingRequestBody

字段 类型 必填 说明
anchor_at string (date-time) Interval phase anchor instant
authorization_card_interaction_id string (uuid)
authorization_confirmation_message_id string
authorization_proposal_message_id string
cron_expr string 5-field cron expression, required for cron schedules
interval_seconds integer (int64) Elapsed interval in seconds
lead_member_id string (uuid) 是 Lead agent member UUID (executor)
owner_member_id string (uuid) Human Owner UUID; omitted defaults to the human caller. Agent callers require an explicit human Owner
project_member_additions array of string Members added to spec.project_id atomically with this write: only lead_member_id and/or owner_member_id, each once. The acting human (caller, or the confirming human for Agent writes) needs project write access. Must be empty for the Inbox
result_notification_policy string: every, failure_only, none Final result DM policy; omitted timer creates default to every. HTTP null is tolerated as omission
run_at string (date-time) Once trigger instant
schedule_kind string: cron, once, interval Schedule mode; omitted means cron
spec SpecStruct 是
timezone string IANA timezone

CreateFileNodeRequestBody

字段 类型 必填 说明
artifact_id string (uuid) 是 Artifact UUID
name string 是 File node name
parent_id string (uuid) Parent node UUID

CreateFolderRequestBody

字段 类型 必填 说明
name string 是 Folder name
parent_id string (uuid) Parent node UUID

CreateGroupRequestBody

字段 类型 必填 说明
avatar_media_id string Avatar media UUID
description string Group description
member_ids array of string 是 Initial OrgMember/Participant UUIDs
metadata object Optional metadata
name string 是 Group name

CreateGroupResult

字段 类型 必填 说明
created_at string (date-time) 是 Creation time
id string (uuid) 是 Created group conversation UUID
member_count integer (int32) 是 Member count

CreateInvitationData

字段 类型 必填 说明
display_name string 是 Invitee's org-level member display name
expires_at string (date-time) 是 Invitation expiry
invitation_id string (uuid) 是 Created invitation UUID
status string 是 Invitation status (pending)
token string Invitation token (returned for agent invitations where email is omitted)

CreateInvitationRequestBody

字段 类型 必填 说明
display_name string 是 Invitee's org-level member display name
email string (email) Invitee email (for human invitations). Omit for agent invitations — use the returned token for programmatic delivery.
message string Optional invitation message
phone_cc string Invitee phone country calling code, digits only, no '+' (e.g. '86'). Paired with phone_number.
phone_number string Invitee national phone number without the country code. Paired with phone_cc.
role_id string (uuid) 是 Initial role to assign upon acceptance

CreateIssueRequestBody

字段 类型 必填 说明
backlog boolean Whether to create in backlog. Defaults to true when omitted; set false to start in_progress
description string Issue description
lead_agent_id string (uuid) 是 Lead agent UUID
origin_conversation_id string (uuid) Origin conversation UUID
origin_message_id string (uuid) Origin message UUID
owner_member_id string (uuid) 是 Issue owner member UUID (required)
priority string: low, medium, high Issue priority (optional, default medium)
title string 是 Issue title

CreateIssueRevisionRequestBody

字段 类型 必填 说明
description string 是
idempotency_key string 是
origin_message_id string

CreateKBRequestBody

字段 类型 必填 说明
description string KB description
icon string KB icon
name string 是 KB name
visibility string: open, closed, private 是 KB visibility

CreatePageRequestBody

字段 类型 必填 说明
body string 是 Page content body
format string: markdown, plain_text 是 Page format
message string Revision message
parent_id string (uuid) Parent node UUID
title string 是 Page title

CreateProjectRequestBody

字段 类型 必填 说明
description string Project description
is_default boolean Whether this is the organization default project
knowledge_base_id string (uuid) Knowledge base UUID; if omitted the org default KB is used (a private project uses the caller's personal knowledge base)
lead_member_id string (uuid) Lead member UUID. Required for an organization project; for a private project omit it or pass the caller (the owner is always the lead).
member_ids array of string Initial project member UUIDs created atomically with the project; for a private project only the caller's own active Agents
name string 是 Project name
scope string: org, private org (default) or private. A private project is visible only to its owner (the caller) and the owner's Agents that are members; creating one needs automation_private_scope_enabled.
slug string Optional project slug. Auto-generated from name when omitted.

CreateSubConversationRequestBody

字段 类型 必填 说明
context_key string 是 The owner's key for this sub-conversation: 1-128 characters of [a-z0-9:_-] (400 COMM_INVALID_CONTEXT_KEY otherwise). A caller that is not an app access token acts as the platform and may only create reply topics, message: of a message in the parent.
owner SubConversationOwnerInput Ignored for app access tokens; see the field docs. The owner is always taken from the credential.
title string Display title. On an existing unarchived sub-conversation it replaces the title.

CreateTaskRequestBody

字段 类型 必填 说明
assignee_id string (uuid) Assignee member UUID
blueprint_step_id string (uuid) Blueprint step UUID
depends_on array of string (uuid) Task dependency UUIDs
description string Task description
title string 是 Task title

CreatedPageItem

字段 类型 必填 说明
created_at string (date-time) 是 Creation time
creator_avatar_url string Creator avatar URL
creator_id string 是 Creator principal ID
creator_name string Creator display name
creator_type string: user, agent, team, system 是 Creator entity type
current_revision_id integer (int64) Current revision ID
format string: markdown, plain_text 是 Page format
id string (uuid) 是 Page UUID
kb_id string (uuid) 是 KB UUID
last_edited_by string Last editor principal ID
last_edited_by_type string: user, agent, team, system Last editor entity type
last_editor_avatar_url string Last editor avatar URL
last_editor_name string Last editor display name
node_id string (uuid) 是 Created tree node UUID
org_id string (uuid) 是 Organization UUID
path string 是 Page path
status string: active, trashed 是 Page status
title string 是 Page title
trashed_at string (date-time) Trash time
updated_at string (date-time) 是 Last update time

Credential

字段 类型 必填 说明
created_at string (date-time) 是
created_by_departed boolean 是
created_by_display_name string 是
created_by_identity_id string 是
id string 是
last_operation_id string 是
prefix string 是
revision integer (int64) 是
revoked_at string (date-time)
scope string 是
status string 是

CreditBreakdownDTO

字段 类型 必填 说明
activity CreditBucketDTO 是
purchased CreditBucketDTO 是
subscription CreditBucketDTO 是
total_available integer (int64) 是

CreditBucketDTO

字段 类型 必填 说明
period_limit integer (int64) 是 Current subscription-period grant total; zero for purchased/activity buckets
remaining integer (int64) 是

CreditGrantDTO

字段 类型 必填 说明
created_at string (date-time)
expires_at string (date-time)
grant_id integer (int64) 是
points_remaining integer (int64) 是
points_total integer (int64) 是
source string 是
source_ref string
status string 是

CreditStatementDTO

字段 类型 必填 说明
balance integer (int64) 是
balance_as_of string (date-time)
consumptions array of CreditStatementEntryDTO 是
expiries array of CreditStatementEntryDTO 是
grants array of CreditStatementEntryDTO 是
has_more boolean 是
manual_adjustments array of CreditStatementEntryDTO 是 Manual deductions, separate from consumption and usage totals; points are positive magnitudes

CreditStatementEntryDTO

字段 类型 必填 说明
addon_id string
agent_identity string Agent identity the entry billed (consumptions only)
agent_name string Resolved agent display name; null when unresolvable (member deleted)
category string Statement category: agent_retainer | agent_usage_prepay | agent_runtime_hourly | llm_usage (consumptions only; empty when uncategorizable)
charge_id integer (int64)
display_description string User-visible manual adjustment description; never the internal operation reason
display_name string User-visible manual adjustment name; may be absent
kind string 是 grant|consumption|expiry|adjustment
ledger_id string Opaque decimal ledger ID for manual adjustments; preserve as a string
occurred_at string (date-time)
online_minutes integer (int64)
online_points_micro_per_minute integer (int64) Exact online rate; 1 credit = 1e6 micro-points
outstanding_points integer (int64)
points integer (int64) 是
points_micro integer (int64) Exact pre-carry runtime-hour amount in micro-points
points_total integer (int64)
settled_points integer (int64)
sku_code string
sleep_minutes integer (int64)
sleep_points_micro_per_minute integer (int64) Exact sleep rate; 1 credit = 1e6 micro-points
source string
source_ref string
status string charged | insufficient_funds for charge-backed consumption rows

CursorListResponseAgentCollabConversationItemBody

字段 类型 必填 说明
data array of AgentCollabConversationItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseAppAgentGrantItemBody

字段 类型 必填 说明
data array of AppAgentGrantItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseCardInteractionAuditItemBody

字段 类型 必填 说明
data array of CardInteractionAuditItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseConversationItemBody

字段 类型 必填 说明
data array of ConversationItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseConversationResourceItemBody

字段 类型 必填 说明
data array of ConversationResourceItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseConversationWorkLinkItemBody

字段 类型 必填 说明
data array of ConversationWorkLinkItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseEventBindingChangeItemBody

字段 类型 必填 说明
data array of EventBindingChangeItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseKbSummaryItemBody

字段 类型 必填 说明
data array of KbSummaryItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseMessageItemBody

字段 类型 必填 说明
data array of MessageItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseMessageSearchHitItemBody

字段 类型 必填 说明
data array of MessageSearchHitItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponsePageItemBody

字段 类型 必填 说明
data array of PageItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseRevisionSummaryItemBody

字段 类型 必填 说明
data array of RevisionSummaryItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseSearchHitItemBody

字段 类型 必填 说明
data array of SearchHitItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorListResponseUserConversationItemBody

字段 类型 必填 说明
data array of UserConversationItem 是 Response payload
pagination CursorMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

CursorMetadata

字段 类型 必填 说明
next_cursor string 是 Cursor for the next page (empty string if no more pages)
total_count integer (int64) Total number of matching items; omitted when the service does not compute a total

D8Error

字段 类型 必填 说明
error D8ErrorPayload 是 Error payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

D8ErrorPayload

字段 类型 必填 说明
code string Stable business error code (business errors only)
detail string A human-readable explanation specific to this occurrence of the problem
errors array of ErrorDetail Optional list of individual error details (validation errors)
field string Offending request field, when attributable (business errors only)
instance string (uri) A URI reference that identifies the specific occurrence of the problem
meta object Structured, machine-readable fields for this error, letting clients localize detail while rendering live values (business errors only, when present)
status integer (int64) 是 HTTP status code
title string A short, human-readable summary of the problem type
type string (uri) A URI reference to human-readable documentation for the error

DataResponseAcceptInvitationDataBody

字段 类型 必填 说明
data AcceptInvitationData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAddonOutstandingDTOBody

字段 类型 必填 说明
data AddonOutstandingDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAdminAgentStorageDTOBody

字段 类型 必填 说明
data AdminAgentStorageDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAgentAvatarDataBody

字段 类型 必填 说明
data AgentAvatarData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAgentCapabilityTagsDataBody

字段 类型 必填 说明
data AgentCapabilityTagsData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAgentChannelBindingItemBody

字段 类型 必填 说明
data AgentChannelBindingItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAgentCreditCapDTOBody

字段 类型 必填 说明
data AgentCreditCapDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAgentRuntimeMetricsDataBody

字段 类型 必填 说明
data AgentRuntimeMetricsData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAnalyticsOverviewBody

字段 类型 必填 说明
data AnalyticsOverview 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAppAgentGrantItemBody

字段 类型 必填 说明
data AppAgentGrantItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseApprovalItemBody

字段 类型 必填 说明
data ApprovalItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAttemptItemBody

字段 类型 必填 说明
data AttemptItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAutoTopupSettingsDTOBody

字段 类型 必填 说明
data AutoTopupSettingsDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAutomationAuthorizationPreviewBody

字段 类型 必填 说明
data AutomationAuthorizationPreview 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAutomationCreationEligibilityBody

字段 类型 必填 说明
data AutomationCreationEligibility 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAutomationHandoffResultBody

字段 类型 必填 说明
data AutomationHandoffResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAutomationProposalResponseBody

字段 类型 必填 说明
data AutomationProposalResponse 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAutomationProposalStatusBody

字段 类型 必填 说明
data AutomationProposalStatus 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAvatarUploadFinalizedBody

字段 类型 必填 说明
data AvatarUploadFinalized 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseAvatarUploadPreparedBody

字段 类型 必填 说明
data AvatarUploadPrepared 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseBalanceAlertSettingsDTOBody

字段 类型 必填 说明
data BalanceAlertSettingsDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseBatchAgentDMEligibilityResultBody

字段 类型 必填 说明
data BatchAgentDMEligibilityResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseBatchGetMessagesResultBody

字段 类型 必填 说明
data BatchGetMessagesResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseBillingCapabilitiesDataBody

字段 类型 必填 说明
data BillingCapabilitiesData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseBillingPaymentOptionsDataBody

字段 类型 必填 说明
data BillingPaymentOptionsData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseBlueprintItemBody

字段 类型 必填 说明
data BlueprintItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCapabilityTagVocabularyDataBody

字段 类型 必填 说明
data CapabilityTagVocabularyData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCardChoiceResultBody

字段 类型 必填 说明
data CardChoiceResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCardInteractionResultBody

字段 类型 必填 说明
data CardInteractionResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCardInteractionSubmitResultBody

字段 类型 必填 说明
data CardInteractionSubmitResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCatalogDTOBody

字段 类型 必填 说明
data CatalogDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseChannelConfirmationStatusBody

字段 类型 必填 说明
data ChannelConfirmationStatus 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectActionItemBody

字段 类型 必填 说明
data ConnectActionItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectAgentBatchAuthorizeDataBody

字段 类型 必填 说明
data ConnectAgentBatchAuthorizeData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectApplicationActionDefItemBody

字段 类型 必填 说明
data ConnectApplicationActionDefItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectApplicationCategoryCountsBody

字段 类型 必填 说明
data ConnectApplicationCategoryCounts 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectApplicationItemBody

字段 类型 必填 说明
data ConnectApplicationItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectConnectFieldsDataBody

字段 类型 必填 说明
data ConnectConnectFieldsData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectConnectionItemBody

字段 类型 必填 说明
data ConnectConnectionItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectCreateConnectionDataBody

字段 类型 必填 说明
data ConnectCreateConnectionData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectExecuteActionDataBody

字段 类型 必填 说明
data ConnectExecuteActionData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectInitiateReauthDataBody

字段 类型 必填 说明
data ConnectInitiateReauthData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectOAuthCallbackURLDataBody

字段 类型 必填 说明
data ConnectOAuthCallbackURLData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectProxyForwardDataBody

字段 类型 必填 说明
data ConnectProxyForwardData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConnectShopifyAppInstallItemBody

字段 类型 必填 说明
data ConnectShopifyAppInstallItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConversationChangesResultBody

字段 类型 必填 说明
data ConversationChangesResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConversationConnectorItemBody

字段 类型 必填 说明
data ConversationConnectorItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConversationConnectorListBody

字段 类型 必填 说明
data ConversationConnectorList 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConversationItemBody

字段 类型 必填 说明
data ConversationItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseConversationMemberBatchResponseBody

字段 类型 必填 说明
data ConversationMemberBatchResponse 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCreateGroupResultBody

字段 类型 必填 说明
data CreateGroupResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCreateInvitationDataBody

字段 类型 必填 说明
data CreateInvitationData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCreatedPageItemBody

字段 类型 必填 说明
data CreatedPageItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseCreditStatementDTOBody

字段 类型 必填 说明
data CreditStatementDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseDisconnectAgentChannelDataBody

字段 类型 必填 说明
data DisconnectAgentChannelData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseEditMessageResultBody

字段 类型 必填 说明
data EditMessageResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseEventBindingItemBody

字段 类型 必填 说明
data EventBindingItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseEventBindingPreviewBody

字段 类型 必填 说明
data EventBindingPreview 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseEventBindingRunBody

字段 类型 必填 说明
data EventBindingRun 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseFileDownloadItemBody

字段 类型 必填 说明
data FileDownloadItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseFilePreviewItemBody

字段 类型 必填 说明
data FilePreviewItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseFinalizeUploadResultBody

字段 类型 必填 说明
data FinalizeUploadResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseFindOrCreateDMResultBody

字段 类型 必填 说明
data FindOrCreateDMResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseGetMeDataBody

字段 类型 必填 说明
data GetMeData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseGetMessageResultBody

字段 类型 必填 说明
data GetMessageResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseHeldWebhookEventsBody

字段 类型 必填 说明
data HeldWebhookEvents 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseHeldWebhookEventsDecisionBody

字段 类型 必填 说明
data HeldWebhookEventsDecision 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInboxStatusResultBody

字段 类型 必填 说明
data InboxStatusResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInitOrgKBDataBody

字段 类型 必填 说明
data InitOrgKBData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInstallmentScheduleDTOBody

字段 类型 必填 说明
data InstallmentScheduleDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInteractionRequestResultBody

字段 类型 必填 说明
data InteractionRequestResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInvoiceApplicationDTOBody

字段 类型 必填 说明
data InvoiceApplicationDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInvoiceArtifactDTOBody

字段 类型 必填 说明
data InvoiceArtifactDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseInvoiceSummaryDTOBody

字段 类型 必填 说明
data InvoiceSummaryDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseIssueItemBody

字段 类型 必填 说明
data IssueItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseKbItemBody

字段 类型 必填 说明
data KbItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseLeaveGroupResultBody

字段 类型 必填 说明
data LeaveGroupResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListAgentChannelCatalogItemBody

字段 类型 必填 说明
data array of AgentChannelCatalogItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListAgentCreditCapDTOBody

字段 类型 必填 说明
data array of AgentCreditCapDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListAgentProfileBody

字段 类型 必填 说明
data array of AgentProfile 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectAgentItemBody

字段 类型 必填 说明
data array of ConnectAgentItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectAgentUsableConnectionsEntryBody

字段 类型 必填 说明
data array of ConnectAgentUsableConnectionsOk | ConnectAgentUsableConnectionsFailure 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectApplicationActionDefItemBody

字段 类型 必填 说明
data array of ConnectApplicationActionDefItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectApplicationsQueryEntryBody

字段 类型 必填 说明
data array of ConnectApplicationsQueryOk | ConnectApplicationsQueryFailure 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectConnectionItemBody

字段 类型 必填 说明
data array of ConnectConnectionItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectConnectionWithAgentsItemBody

字段 类型 必填 说明
data array of ConnectConnectionWithAgentsItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConnectToolkitItemBody

字段 类型 必填 说明
data array of ConnectToolkitItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListConversationMemberItemBody

字段 类型 必填 说明
data array of ConversationMemberItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListEventBindingItemBody

字段 类型 必填 说明
data array of EventBindingItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListEventOccurrenceItemBody

字段 类型 必填 说明
data array of EventOccurrenceItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListFileDownloadResultItemBody

字段 类型 必填 说明
data array of FileDownloadResultItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListMessageEditsResultBody

字段 类型 必填 说明
data ListMessageEditsResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListMyInvitationsDataBody

字段 类型 必填 说明
data ListMyInvitationsData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListMyProvisioningAgentSummaryBody

字段 类型 必填 说明
data array of MyProvisioningAgentSummary 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListObservedMemberItemBody

字段 类型 必填 说明
data array of ObservedMemberItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListObserverMemberItemBody

字段 类型 必填 说明
data array of ObserverMemberItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListOwnedAgentSummaryBody

字段 类型 必填 说明
data array of OwnedAgentSummary 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListPageReferenceItemBody

字段 类型 必填 说明
data array of PageReferenceItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListPlatformAgentOperationalStateDTOBody

字段 类型 必填 说明
data array of PlatformAgentOperationalStateDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListTreeNodeItemBody

字段 类型 必填 说明
data array of TreeNodeItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListTreeNodeWithChildrenItemBody

字段 类型 必填 说明
data array of TreeNodeWithChildrenItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListWebhookDeliveryItemBody

字段 类型 必填 说明
data array of WebhookDeliveryItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseListWorkReferenceItemBody

字段 类型 必填 说明
data array of WorkReferenceItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseMapStringBoolBody

字段 类型 必填 说明
data object 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseMapStringInterface {}Body

字段 类型 必填 说明
data object 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseMarkMentionsReadResultBody

字段 类型 必填 说明
data MarkMentionsReadResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseMarkReadResultBody

字段 类型 必填 说明
data MarkReadResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseMentionQueueResultBody

字段 类型 必填 说明
data MentionQueueResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseModelCatalogDataBody

字段 类型 必填 说明
data ModelCatalogData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseOrderCheckoutDTOBody

字段 类型 必填 说明
data OrderCheckoutDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseOrderFateDTOBody

字段 类型 必填 说明
data OrderFateDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseOrderHistoryDTOBody

字段 类型 必填 说明
data OrderHistoryDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseOrganizationDeletionPrecheckDataBody

字段 类型 必填 说明
data OrganizationDeletionPrecheckData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseOrganizationDetailBody

字段 类型 必填 说明
data OrganizationDetail 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePageContentItemBody

字段 类型 必填 说明
data PageContentItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePageItemBody

字段 类型 必填 说明
data PageItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePaymentMethodListDTOBody

字段 类型 必填 说明
data PaymentMethodListDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePlanStateDTOBody

字段 类型 必填 说明
data PlanStateDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePlatformAgentDomainAvailabilityDataBody

字段 类型 必填 说明
data PlatformAgentDomainAvailabilityData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePlatformAgentDomainConfigDataBody

字段 类型 必填 说明
data PlatformAgentDomainConfigData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePlatformAgentDomainDataBody

字段 类型 必填 说明
data PlatformAgentDomainData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePollAgentDingtalkScanDataBody

字段 类型 必填 说明
data PollAgentDingtalkScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePollAgentFeishuScanDataBody

字段 类型 必填 说明
data PollAgentFeishuScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePollAgentLarkScanDataBody

字段 类型 必填 说明
data PollAgentLarkScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePollAgentWecomScanDataBody

字段 类型 必填 说明
data PollAgentWecomScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePrepareUploadItemBody

字段 类型 必填 说明
data PrepareUploadItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePrepareUploadResultBody

字段 类型 必填 说明
data PrepareUploadResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePrivateWorkspaceResultBody

字段 类型 必填 说明
data PrivateWorkspaceResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponsePrivateWorkspaceStatusBody

字段 类型 必填 说明
data PrivateWorkspaceStatus 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseProjectItemBody

字段 类型 必填 说明
data ProjectItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseProjectMemberItemBody

字段 类型 必填 说明
data ProjectMemberItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseQuotaBody

字段 类型 必填 说明
data Quota 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseReactionChangeResultBody

字段 类型 必填 说明
data ReactionChangeResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseReadCursorsResultBody

字段 类型 必填 说明
data ReadCursorsResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseRecallMessageResultBody

字段 类型 必填 说明
data RecallMessageResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseResolveURIsDataBody

字段 类型 必填 说明
data ResolveURIsData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseRevisionDiffItemBody

字段 类型 必填 说明
data RevisionDiffItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseSendMessageResultBody

字段 类型 必填 说明
data SendMessageResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseSetAppBadgesDataBody

字段 类型 必填 说明
data SetAppBadgesData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStarListBody

字段 类型 必填 说明
data StarList 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStartAgentDingtalkScanDataBody

字段 类型 必填 说明
data StartAgentDingtalkScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStartAgentFeishuScanDataBody

字段 类型 必填 说明
data StartAgentFeishuScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStartAgentLarkScanDataBody

字段 类型 必填 说明
data StartAgentLarkScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStartAgentWecomScanDataBody

字段 类型 必填 说明
data StartAgentWecomScanData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStartAgentWhatsappBusinessRegistrationDataBody

字段 类型 必填 说明
data StartAgentWhatsappBusinessRegistrationData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStartTaskDataBody

字段 类型 必填 说明
data StartTaskData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseStruct {}Body

字段 类型 必填 说明
data DataStruct 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseSubConversationResultBody

字段 类型 必填 说明
data SubConversationResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseSubmitAgentWhatsappBusinessCodeDataBody

字段 类型 必填 说明
data SubmitAgentWhatsappBusinessCodeData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseSubscriptionIntentReadDTOBody

字段 类型 必填 说明
data SubscriptionIntentReadDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseSyncResultBody

字段 类型 必填 说明
data SyncResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseTaskItemBody

字段 类型 必填 说明
data TaskItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseTimezonesDataBody

字段 类型 必填 说明
data TimezonesData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseTreeNodeItemBody

字段 类型 必填 说明
data TreeNodeItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseUnreadCountResultBody

字段 类型 必填 说明
data UnreadCountResult 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseUpdateMeDataBody

字段 类型 必填 说明
data UpdateMeData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseUpdateMemberDisplayNameDataBody

字段 类型 必填 说明
data UpdateMemberDisplayNameData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseUpdateOrganizationDataBody

字段 类型 必填 说明
data UpdateOrganizationData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseUsageSummaryDTOBody

字段 类型 必填 说明
data UsageSummaryDTO 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseWebhookDeliveryItemBody

字段 类型 必填 说明
data WebhookDeliveryItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseWebhookItemBody

字段 类型 必填 说明
data WebhookItem 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataResponseWsTicketDataBody

字段 类型 必填 说明
data WsTicketData 是 Response payload
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

DataStruct

object

DecideApprovalRequestBody

字段 类型 必填 说明
reason string Decision reason
status string: approved, rejected 是 Decision status

DecideHeldWebhookEventsRequestBody

字段 类型 必填 说明
cursor string 是 cursor of the held-events read this decision answers; an empty cursor (nothing was waiting) decides nothing
delivery_ids array of string Held delivery UUIDs to replay: at least one for mode selected, absent otherwise
mode string: all, selected, none 是 all replays every replayable event, selected replays delivery_ids, none replays nothing. Replayable events not replayed are recorded as declined; expired and over-limit ones as decided
request_id string (uuid) 是 UUID chosen by the client per decision; repeating it returns the first result

DeliverIssueBody

字段 类型 必填 说明
artifacts array of AutomationArtifactItem
idempotency_key string
outcome string: success, partial, failed
summary string

DisconnectAgentChannelData

字段 类型 必填 说明
success boolean 是 Whether the disconnect command was accepted for dispatch

DisconnectConnectConnectionRequestBody

字段 类型 必填 说明
actor_member_id string Optional acting member UUID. The actor is always the authenticated caller: if provided it must equal the caller's member UUID (case-insensitive), otherwise the request is rejected with 403 AUTH_FORBIDDEN. Omit to use the caller.

DmDetailItem

字段 类型 必填 说明
billing_suspended boolean True when the agent peer is stopped by billing enforcement (arrears). Advisory: the DM remains writable. Omitted when unknown.
billing_suspension_reason string The platform's reason for the stop (e.g. insufficient_credits, agent_arrears); set only alongside billing_suspended=true
can_send boolean Whether the current user can send messages to this DM peer
credit_cap_reached boolean True when the agent credit cap (daily or monthly) is the effective stop reason. Advisory: the DM remains writable.
peer_avatar_url string Peer avatar URL (resolved server-side)
peer_display_name string Peer display name (resolved server-side)
peer_kind string: human, agent, system Peer member kind (resolved server-side; system for System Member DMs)
peer_member_id string (uuid) 是 Peer OrgMember/Participant UUID
peer_status string: active, suspended, departed Peer member status (resolved server-side)
read_only_reason string: peer_suspended, peer_departed, system_dm_readonly Reason this DM is read-only when can_send is false

EditMessageRequestBody

字段 类型 必填 说明
content MessageContentItem 是 Replacement content (full MessageContent shape)
fallback_text string Replacement preview/fallback text — the short plaintext the conversation list shows for non-text messages. Omit to leave the stored value unchanged. Capped at 8192 UTF-8 bytes by the platform.
type string: UNSPECIFIED, TEXT, IMAGE, FILE, AUDIO, VIDEO, SYSTEM, AGENT_TEXT, AGENT_STRUCTURED, AGENT_CARD, AGENT_STREAM Replacement message kind, e.g. editing an image message into pure text so neither the bubble nor the conversation-list preview renders it as an image. Omit to leave the kind unchanged.

EditMessageResult

字段 类型 必填 说明
change_seq integer (int64) 是 Conversation change_seq this edit allocated, so the acting device can advance its change watermark and drop the realtime frame for its own change
edited_at integer (int64) 是 Edit timestamp (unix ms)

EnsurePrivateWorkspaceRequestBody

字段 类型 必填 说明
knowledge_base_name string Name used only when the personal knowledge base is created; defaults to the Chinese-language name for "My knowledge base"
project_name string Name used only when the personal project is created; defaults to the Chinese-language name for "My private project"

EntitlementsDTO

字段 类型 必填 说明
agent_slots integer (int64) 是
grant_points integer (int64) 是
included_agents array of IncludedAgentDTO 是
member_limit integer (int64) 是
trial_days integer (int64) 是
trial_grant_points integer (int64) 是

ErrorDetail

字段 类型 必填 说明
location string Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
message string Error message text
value any The value at the given location

EventBindingChangeItem

字段 类型 必填 说明
actor_member_id string
actor_name string Current Agent or trusted chat-confirming Owner display name when available; not a historical name snapshot
actor_service_id string
actor_source string Trusted confirmation source; conversation_confirmed for Owner-confirmed chat changes
actor_type string 是 Authenticated source: owner, agent or system
changes array of EventBindingFieldChange 是
created_at string (date-time) 是
event_binding_id string (uuid) 是
id string (uuid) 是
kind string 是 updated or trigger_replaced
parent_binding_id string

EventBindingFieldChange

字段 类型 必填 说明
after string 是 New display value; sensitive fields use safe markers
before string 是 Previous display value; sensitive fields use safe markers
field string 是 Changed configuration field
redacted boolean 是 Values are safe markers rather than original content

EventBindingItem

字段 类型 必填 说明
anchor_at string (date-time) Interval phase anchor instant
completed boolean 是 Whether the current single-run schedule has created its Issue and is no longer active; does not imply Issue execution success
created_at string (date-time) 是 Creation time
created_by_member_id string (uuid) Original confirming human; absent when the creator is unknown
cron_expr string 是 5-field cron expression
display_status string 是 Authoritative automation state: enabled, paused, needs_attention or ended
enabled boolean 是 Whether the binding is active
held_event_count integer (int32) 是 Webhook only: held events still waiting for the Owner's replay decision, expired and over-limit ones included; 0 for a reader without run history access
id string (uuid) 是 EventBinding UUID
interval_seconds integer (int64) Fixed elapsed interval in seconds
last_run EventOccurrenceItem Latest unified run, with the latest revision outcome
lead_member_id string (uuid) 是 Lead agent member UUID (executor)
next_trigger_at string (date-time) 是 Next scheduled fire time for timer bindings; webhook bindings carry an internal sentinel, not a schedule
org_id string (uuid) 是 Organization UUID
owner_member_id string (uuid) 是 Owner member UUID (human governance anchor)
pause_reason string Server-supplied pause or blocking reason
replaced_by_binding_id string (uuid) New automation replacing this paused binding
replaces_binding_id string (uuid) Previous automation retained when its trigger type changed
result_notification_policy string: every, failure_only, none 是 Final result DM policy for future runs; partial completion counts as failure
result_notification_policy_migrated boolean 是 Show the migrated webhook policy notice until the Owner explicitly writes this setting
run_at string (date-time) Once schedule trigger instant
schedule_kind string 是 Schedule mode: cron, once or interval
scope string: org, private 是 Scope of the automation's project: private automations are visible only to the project owner and the owner's Agents
source_kind string 是 Source kind: timer or webhook
spec EventBindingSpec 是 Issue template applied on each fire
timezone string 是 IANA timezone; empty when no timezone is applied to the schedule
updated_at string (date-time) 是 Last update time
version integer (int64) 是 Configuration version for optimistic concurrency

EventBindingPreview

字段 类型 必填 说明
next_trigger_at array of string (date-time) 是 Upcoming scheduled trigger instants

EventBindingRun

字段 类型 必填 说明
occurrence EventOccurrenceItem 是 Occurrence and the created Issue reference
reused boolean 是 Whether the key already identified an existing manual run

EventBindingSpec

字段 类型 必填 说明
delivery_conversation_id string Server-resolved owner and lead DM
description string Issue description
knowledge_base_id string (uuid) Knowledge base of the runs when knowledge_base_mode is custom
knowledge_base_mode string: project_default, custom, none 是 Where runs store their outputs: the project's knowledge base, knowledge_base_id, or none
project_id string (uuid) 是 Project UUID the created Issue belongs to; for an unattached automation the system project it runs in (the Inbox, or the Owner's hidden private project)
title string 是 Issue title
unattached boolean 是 The automation belongs to no project; project_id is the system project it runs in, which is never listed

EventOccurrenceItem

字段 类型 必填 说明
approval_request_ids array of string 是 Approval references on current blocked attempts; read each approval for its current decision state
artifacts array of AutomationArtifactItem 是 Latest revision output links
attempt_count integer (int32) 是 Number of occurrence processing attempts
created_at string (date-time) 是 Occurrence record creation instant
created_issue_id string (uuid) Created issue UUID, when issue creation succeeded
error_code string Recorded occurrence or notification error code, when present
event_binding_id string (uuid) 是 Parent EventBinding UUID
id string (uuid) 是 Occurrence UUID
is_partial boolean 是 Successful delivery with validated partial completion
latest_issue_id string (uuid) Issue for the latest revision of this run
notification_status string 是 Lead notification delivery status
replay_decided_at string (date-time) When the Owner decided on this held event; omitted while undecided
replay_state string: held, replay, declined, excluded, expired, overflow Webhook runs only: held-event replay state; omitted for a run that was never held. A replayed run keeps the received time as scheduled_at
result_notification_policy string: every, failure_only, none Immutable result DM policy of the latest run or revision
result_notification_status string: pending, sent, suppressed Final result DM status; omitted before a result, distinct from initial Lead dispatch notification_status. Delivery failures remain pending for retry
revision_count integer (int32) 是 Number of linked revisions
revision_issue_ids array of string 是 All retained Issue versions, including the original, ordered oldest to latest
run_reason string Server-supplied interruption or blocking reason
run_status string 是 Authoritative run state: running, awaiting_confirmation, success, interrupted or ended; ended does not assert success
scheduled_at string (date-time) 是 Scheduled trigger instant for timers; received instant for webhooks
status string 是 Occurrence processing status; not the created issue's execution outcome
summary string Latest revision delivery summary
trigger_kind string 是 Run trigger: timer, manual or webhook

ExecuteConnectActionRequestBody

字段 类型 必填 说明
action string 是 Action name
params any Action parameters

ExpireApprovalRequestBody

字段 类型 必填 说明
reason string Expiry reason

FileDownloadErrorItem

字段 类型 必填 说明
code string: not_found, not_a_file, no_artifact, resolve_failed 是 Error code
message string 是 Error message

FileDownloadItem

字段 类型 必填 说明
artifact_id string 是 Artifact ID
content_length integer (int64) 是 Content length in bytes
content_type string 是 Content type
download_url string 是 Download URL: a presigned storage URL, or, when knowledge-base download tickets are enabled, a short-lived platform URL (GET /api/public/artifacts/download/{ticket}) that redirects to one
expires_at string (date-time) Download URL expiration time (the ticket expiry when download_url is a ticket URL)
name string 是 File name
node_id string (uuid) 是 Tree node UUID

FileDownloadResultItem

字段 类型 必填 说明
download FileDownloadItem Successful download result
error FileDownloadErrorItem Per-node download error
node_id string (uuid) 是 Tree node UUID

FilePreviewItem

字段 类型 必填 说明
artifact_id string 是 Artifact ID
category string: image, pdf, document, code, text, unsupported 是 Preview category
message string 是 Preview status message
name string 是 File name
node_id string (uuid) 是 Tree node UUID
path string 是 File path
supported boolean 是 Whether preview is supported

FinalizeAvatarUploadInputBody

字段 类型 必填 说明
artifact_id string (uuid) 是 Prepared avatar artifact UUID
session_id string (uuid) 是 Prepared upload-session UUID

FinalizeCommUploadRequestBody

字段 类型 必填 说明
upload_token string 是 Upload token

FinalizeUploadRequestBody

字段 类型 必填 说明
upload_token string 是 Opaque upload token

FinalizeUploadResult

字段 类型 必填 说明
artifact_id string 是 Artifact UUID
media_id string 是 Media UUID

FindOrCreateDMRequestBody

字段 类型 必填 说明
peer_member_id string (uuid) 是 Peer OrgMember/Participant UUID

FindOrCreateDMResult

字段 类型 必填 说明
conversation ConversationItem 是 Conversation
created boolean 是 Whether a new DM was created

FormFieldInput

字段 类型 必填 说明
allow_other boolean Choice questions only: adds an other choice the answerer can tick and describe in free text
description string Optional explanation under the question
key string 是 Stable question key, unique on the card; answers and the receipt are keyed by it
label string 是 The question. A text question, or a choice question that offers other, is refused when its key, label, description or placeholder names a secret (password, key, token, verification code,...).
max_length integer (int32) Text questions only: most characters (grapheme clusters) an answer takes; nothing is truncated. Omit for the platform's default, which depends on multiline. The platform holds the bounds.
max_select integer (int32) Most choices an answered multiple question takes, a ticked other choice counting as one. Only for a choice question with selection_mode=multiple.
min_length integer (int32) Text questions only: fewest characters (grapheme clusters) a non-empty answer takes. Omit for none.
min_select integer (int32) Fewest choices an answered multiple question takes, a ticked other choice counting as one. Only for a choice question with selection_mode=multiple.
multiline boolean Text questions only: a multi-line answer box. The platform caps how many a card may have.
options array of FormOptionInput The choices, in display order; a choice question needs them. The platform caps how many and rejects duplicate option text within a question. A text question that carries options, selection_mode, min_select, max_select or allow_other is refused.
placeholder string Text questions only: plain-text hint shown in the empty answer box. Omit for the client's default.
required boolean Deprecated and has no effect: every question is optional. A one-question card still has to be answered. (已弃用)
selection_mode string Choice questions only: single (what empty means) or multiple. The platform judges the value and how it combines with min_select, max_select and exclusive.
type string Question type: choice (what empty means) or text, a fill-in answer. The platform refuses any other value, and refuses text while fill-in questions are switched off.

FormGroupInput

字段 类型 必填 说明
id string 是 Set id shared by every card of the batch
index integer (int32) 是 1-based position of this card in the set
total integer (int32) 是 Number of cards in the set

FormInteractionInput

字段 类型 必填 说明
answerers array of string Member ids of the only people who may submit. Each must be a current human member of the conversation; they are also @mentioned by the card. Omit to let any member answer.
blocks array of object Optional context above the questions, from the same block types a choice card accepts. May be empty.
fields array of FormFieldInput 是 The questions, in display order. The platform caps how many.
group FormGroupInput Marks this card as part index of total cards that together ask one batch of questions. Validated and echoed, not joined.
summary string 是 One-line summary, also the plain-text projection for clients that cannot render the card
title string 是 Card title

FormOptionInput

字段 类型 必填 说明
description string Optional explanation under the option
exclusive boolean Marks the none-of-these option of a multiple question: an answer that chooses it must choose nothing else, the other choice included. At most one per question.
key string Optional stable option key, unique within the question, echoed in the receipt. The server-generated option id stays the identifier answers use.
label string 是 Option text
recommended boolean Tags the option as recommended; nothing is preselected

GetIntlInvoiceProfileResponseBody

字段 类型 必填 说明
data IntlInvoiceProfileDTO 是 The org's Bill to profile; null when never filled
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

GetMeData

字段 类型 必填 说明
auth_source string: sso, password Account origin for HUMAN identities: sso when the identity has an SSO credential binding, password otherwise. Reflects the account's registration/binding state, not how the current session logged in; binding SSO later flips it to sso. Omitted for non-human identities (agents authenticate via API keys — neither value applies)
avatar_url string Avatar URL
contact_email string UNVERIFIED contact email the user typed into their own profile; omitted when unset. NOT USED FOR AUTHENTICATION: no login, no verification code, no account-security mail is ever addressed to it, and no verification of it is performed or implied — there is no accompanying verified flag because the value is never verified. It exists because China-region registration collects only a phone number, so no email address is captured at sign-up and the product collects one as plain contact information. Treat it as free-text contact info, never as identity. The credential address is email.
created_at string (date-time) 是 Identity creation time
display_name string 是 Display name
email string LOGIN email address for identities backed by an email-password account (or the SSO provider's email for SSO-only identities). This is the account's credential/verification address: it is what account-security flows such as the organization self-service deletion verification code are sent to. Not user-editable through this API. NOT the same value as contact_email — do not read one when you mean the other.
identity_id string (uuid) 是 The authenticated identity's UUID
kind string: human, agent 是 Identity type
locale string: en, zh Identity-level preferred language; omitted when unset (recipients then fall back to en)
member_id string (uuid) Member ID within the current org
member_kind string: human, agent Member type in the current org
org_id string (uuid) Current organization ID (present when JWT is org-scoped)
org_name string Current organization name
org_slug string Current organization slug
phone_cc string Primary phone country calling code (digits only, no +); omitted when unset
phone_number string Primary phone national number (without country code); omitted when unset
role GetMeRoleItem Role assigned in the current org (omitted for identity-only JWT)

GetMeRoleItem

字段 类型 必填 说明
display_name string 是 Role display name
scope string: org 是 Role scope
scope_id string (uuid) Scoped entity ID (org ID)
slug string 是 Role slug (e.g. org-owner, org-admin, org-member)

GetMemberResponseBody

字段 类型 必填 说明
agent_origin string: platform_created, external_invited Agent membership origin; omitted for non-agent members
agent_readiness string: provisioning, ready Platform agent provisioning readiness. 'provisioning' = creation still in flight, hold chat entry; 'ready' = has proved alive. OMITTED means the member is not subject to the provisioning gate — treat absent as not gated, never as not ready.
agent_type string Agent runtime type (e.g. hermes, claude_code); omitted for non-agent members
avatar_url string Avatar URL
created_at string (date-time) 是 Record creation time
creator_member_id string (uuid) Creator member ID (for agent members, immutable)
display_name string 是 Display name
email string Email address (human members only)
identity_id string (uuid) 是 Identity UUID
joined_at string (date-time) 是 When the member joined the org
kind string: human, agent, system 是 Member type
locale string: en, zh Identity-level preferred language; omitted when unset (fallback: en)
member_id string (uuid) 是 Member UUID
online_status string: online, offline, unknown Online status (unknown if it cannot be determined)
operational_state PlatformAgentOperationalStateDTO
operational_state_availability string: available, unavailable, not_applicable Availability of the authoritative billing control state; runtime observation is independent
owner_member_id string (uuid) Owner member ID (for agent members)
request_id string (uuid) 是 Request trace ID
role MemberRole 是 Assigned role (single-role model)
server_time string (date-time) 是 Server timestamp
status string: active, suspended, departed 是 Member status
subsystem_key string: approval_center, scheduler, notification_center, interaction_center Platform subsystem key (system members only); stable key for client-side name localization

GetMessageResult

字段 类型 必填 说明
content MessageContentItem Expanded content
inbox_seq integer (int64) Caller's own inbox sequence for this message (per-user); omitted when the caller has no inbox entry
message MessageItem 是 Message

GetPolicyChangeResponseBody

字段 类型 必填 说明
applied_at string (date-time) When an agent report confirmed the change (for a batch: its last item); absent while unconfirmed
change_id string 是 Policy change ID
created_at string (date-time) 是 When the web edit was accepted
item string 是 Changed setting: batch (an update-agent-policy batch; see items) | group_mode:{conversation_id} | group_allow_from:{conversation_id}
items array of string Batch only: the items of the batch (dm_policy | dm_allowlist | group_scope | group_allowlist), in that fixed order; absent for a per-group change
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
status string: applying, applied, failed 是 applied once an agent report carried the requested value; applying for the first 30 seconds; failed after that (a late report can still turn it applied)

GetPolicyResponseBody

字段 类型 必填 说明
dm_allowlist array of string 是 Member UUIDs in the DM allowlist
dm_policy string 是 DM access policy
group_allowlist array of string 是 Conversation UUIDs in the group allowlist
group_allowlist_names object Conversation UUID to display name mapping for group allowlist entries
group_scope string 是 Group access scope
groups array of AgentGroupPolicyItem 是 Per-group policy settings
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
updated_at integer (int64) 是 Last policy update timestamp (unix seconds)

GroupDetailItem

字段 类型 必填 说明
admin_count integer (int32) 是 Admin count
description string 是 Group description

HeldWebhookEventItem

字段 类型 必填 说明
cause string: paused, org_suspended 是 Why the event was held: the automation was paused, or the organization was suspended
delivery_id string (uuid) 是 Held webhook delivery UUID
received_at string (date-time) 是 When the event was received
summary string 是 Event type and title from common GitLab/GitHub fields, else the first 120 characters of the event JSON. Untrusted sender text

HeldWebhookEvents

字段 类型 必填 说明
cursor string 是 Opaque. Pass it to the decision: only events listed up to this read are decided. Empty when nothing is waiting for a decision
expired integer (int32) 是 Held events whose content expired with the payload retention; cannot be replayed
items array of HeldWebhookEventItem 是 Replayable events (matching the current filter), oldest first, at most 200
lead_paused boolean 是 The Lead Agent is suspended: replayed runs start after it is resumed
org_suspended boolean 是 The organization is suspended: a decision answers 409 WORK_ORG_SUSPENDED
overflow integer (int32) 是 Events past the per-automation hold limit, kept without content; cannot be replayed
replayable integer (int32) 是 Held events that match the current filter and can be replayed

HeldWebhookEventsDecision

字段 类型 必填 说明
decision_id string (uuid) 是 Replay decision UUID
declined integer (int32) 是 Replayable events not replayed
excluded integer (int32) 是 Held events that no longer match the current filter
expired integer (int32) 是 Expired events marked as decided
mode string: all, selected, none 是 Decided mode
overflow integer (int32) 是 Over-limit events marked as decided
replayed integer (int32) 是 Events queued for replay; their Issues are created in received order about 3 seconds apart and consume credits
reused boolean 是 request_id was decided before and this is the stored result

InboxStatusResult

字段 类型 必填 说明
last_delivered_seq integer (int64) 是 Highest sync sequence already delivered to the caller
max_seq integer (int64) 是 Highest sync sequence currently available for the caller's inbox

IncludedAgentDTO

字段 类型 必填 说明
count integer (int32) 是
tier string 是

InflightOrderDTO

字段 类型 必填 说明
biz_order_id string 是
can_cancel boolean 是 Whether this exact in-flight order may be synchronously canceled and replaced
status string 是

InitOrgKBData

字段 类型 必填 说明
org_id string (uuid) 是 Organization UUID
status string 是 Initialization status

InstallmentItemDTO

字段 类型 必填 说明
expires_at string (date-time)
grant_id integer (int64) 0 = not granted yet
month_index integer (int32) 是 1-based period index within the purchase
points integer (int64) null = not yet determined; read together with points_projected. NOT collapsed to 0.
points_projected boolean 是 true = points is a projection, not a settled fact
scheduled_at string (date-time)
status string 是

InstallmentScheduleDTO

字段 类型 必填 说明
billing_interval string
biz_order_id string 是
granted_installments integer (int32) 是
installments array of InstallmentItemDTO 是
order_status string 是
order_type string 是
paid_at string (date-time)
plan_code string
total_installments integer (int32) 是

InteractionRequestResult

字段 类型 必填 说明
action_ids array of string 是 Server-generated ids of the options, in the order they were supplied. Empty for a form card, whose ids are in form_option_ids.
created_at string (date-time) 是 When the card was sent
form_option_ids object Form cards only: question key to the server-generated ids of that question's options, in card order; a text question maps to an empty list
message_id string 是 The card message that was sent
seq integer (int64) 是 Conversation sequence number of the card

InterruptAgentRuntimeResponseBody

字段 类型 必填 说明
data AgentRuntimeCommandResult 是 Accepted runtime command result
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

IntlInvoiceProfileDTO

字段 类型 必填 说明
address string Bill to address, newlines kept; absent when not filled
company string Bill to company; absent when not filled
email string 是 Bill to email
name string 是 Bill to name
updated_at string (date-time) Last saved at

InvitationSummary

字段 类型 必填 说明
accepted_at string (date-time) When the invitation was accepted
created_at string (date-time) 是 Invitation creation time
display_name string 是 Invitee's org-level member display name
email string Invitee email (null for agent invitations)
expires_at string (date-time) 是 Invitation expiry
invitation_id string (uuid) 是 Invitation UUID
invited_by_member_id string (uuid) 是 Member who sent the invitation
role_slug string 是 Assigned role slug
status string: pending, accepted, revoked, expired 是 Invitation status

InvoiceApplicationDTO

字段 类型 必填 说明
application_no string 是 The billing system's own user-visible application number (not the legal invoice number)
buyer_address string Buyer's address; company_special (special VAT fapiao) only
buyer_bank_account string Buyer's bank account number; company_special (special VAT fapiao) only
buyer_bank_name string Buyer's bank name; company_special (special VAT fapiao) only
buyer_email string
buyer_name string 是
buyer_tax_id string Empty for personal normal invoices
buyer_tel string Buyer's phone number; company_special (special VAT fapiao) only
created_at string (date-time)
currency string 是
failure_code string
failure_message string
id integer (int64) 是
invoice_no string Legal invoice number (set after issuance)
invoice_type string 是 personal_normal|company_normal|company_special
issued_at string (date-time)
ofd_url string
order_ids array of string 是 Business order ids this application covers
orders array of InvoiceOrderLineDTO Per-order lines for the detail view's related-orders table (order number, type, invoiceable amount, payment time); detail read path only
pdf_url string
red_buyer_confirmation_status string Buyer confirmation status of the red-letter confirmation, as the tax-invoice provider's raw status text (Chinese display text, not a normalized enum: pending confirmation, confirmed, rejected or timed out); empty when not yet known
red_confirmation_deadline_at string (date-time)
red_confirmation_no string
status string 是 payment_create_pending|issuing|issued|failed|voiding|voided
tax_amount_minor integer (int64) 是 Tax amount in currency minor units; 0 until issued
total_amount_minor integer (int64) 是 Invoice total in currency minor units (CNY fen)
void_reason string
void_requested_at string (date-time)

InvoiceArtifactDTO

字段 类型 必填 说明
invoice_no string 是 Legal invoice number
ofd_url string
pdf_url string

InvoiceHistoryDTO

字段 类型 必填 说明
auto_topup boolean true when the credit_pack was bought by auto top-up
billing_interval string month|quarter|year for a plan-class order; empty for credit_pack
credit_points integer (int64) Credits bought by a credit_pack order; 0 for other order types
currency string Order settlement currency (USD|CNY)
invoice_no string 是
issued_at string (date-time)
line_items array of InvoiceLineItemDTO 是
order_invoice_status string Per-order domestic-invoice status (invoiceable|issuing|issued), derived from CN invoice occupancy/applications; empty on orders with no CN invoice track (e.g. USD orders)
order_type string subscription|renewal|plan_change|credit_pack
payment_method string card|wechat|alipay; may be empty when the method is not known
period_end string (date-time)
period_start string (date-time)
plan_code string Plan code of a plan-class order (subscription|renewal|plan_change); empty for credit_pack
provider_receipt_url string
refunded_amount_cents integer (int64) Cumulative refunded amount in currency minor units. Absent = not known (the refund read failed or is not performed), and clients show no refund label; present (including 0) = known
tax_cents integer (int64) 是
total_cents integer (int64) 是

InvoiceLineItemDTO

字段 类型 必填 说明
amount_cents integer (int64) 是
desc string 是
qty integer (int64) 是
unit_cents integer (int64) 是

InvoiceOrderLineDTO

字段 类型 必填 说明
biz_order_id string 是
currency string 是
order_type string 是 subscription|renewal|plan_change|credit_pack
paid_amount_minor integer (int64) 是 Order paid amount in currency minor units (CNY fen)
paid_at string (date-time)
target_ref string plan_code (subscription/renewal/plan_change) or product code (credit_pack)

InvoiceSummaryDTO

字段 类型 必填 说明
currency string Settlement currency of the amounts (CNY); empty when the org has no domestic-invoiceable orders
issued_minor integer (int64) 是 Sum of already-issued order amounts in currency minor units (CNY fen)
remaining_invoiceable_minor integer (int64) 是 Sum of still-invoiceable order amounts in currency minor units (CNY fen)

InvoiceableOrderDTO

字段 类型 必填 说明
application_id integer (int64) Linked invoice application id; 0 when the order has no application yet (invoiceable)
biz_order_id string 是
currency string 是
invoiceable_status string 是 invoiceable|issuing|issued
order_type string 是 subscription|renewal|plan_change|credit_pack
paid_amount_minor integer (int64) 是 Paid amount in currency minor units (CNY fen)
paid_at string (date-time)
target_ref string plan_code (subscription/renewal/plan_change) or product code (credit_pack)

IssueItem

字段 类型 必填 说明
acceptance_source string: im, explicit, text_card_proxy, auto Acceptance source; auto does not represent human approval
accepted_at string (date-time) Acceptance time
archived_at string (date-time) Archive time
automation_policy string Server-owned automatic workflow policy; silent for new automation runs
automation_root_issue_id string Original automation run issue for linked revisions
created_at string (date-time) 是 Creation time
current_blueprint_id string (uuid) Current blueprint UUID
current_plan_text string Exact submitted plan text; absent when no plan text was saved (for example for a silent automation)
current_plan_token string Opaque ordinary plan submission token used to guard human decisions
delivery AutomationDeliveryItem Persisted result and independent notification state
description string 是 Issue description
id string (uuid) 是 Issue UUID
is_automation boolean 是 Server-verified automation origin; does not grant silent execution or bypass human acceptance
knowledge_base_id string (uuid) 是 Knowledge base captured when the issue was created; unaffected by project default changes
lead_agent_id string (uuid) Lead agent UUID
lead_agent_status string: active, suspended, departed Current membership status of the lead member
org_id string (uuid) 是 Organization UUID
origin_conversation_id string (uuid) Origin conversation UUID
origin_message_id string Origin message identifier; message identifiers may be decimal strings
owner_member_id string (uuid) 是 Issue owner member UUID; only this member can accept delivered work
priority string: low, medium, high 是 Issue priority
project_id string (uuid) 是 Project UUID
result_notification_policy string: every, failure_only, none Immutable result DM policy captured for this automation run
status string: backlog, in_progress, pending_plan, delivered, accepted, terminated 是 Issue status
terminated_at string (date-time) Early-termination time
termination_reason string Early-termination reason
title string 是 Issue title
updated_at string (date-time) 是 Last update time

JWK

字段 类型 必填 说明
alg string 是
e string 是
kid string 是
kty string 是
n string 是
use string 是

JWKSet

字段 类型 必填 说明
keys array of JWK 是

KbItem

字段 类型 必填 说明
created_at string (date-time) 是 Creation time
creator_id string 是 Creator principal ID
creator_type string: user, agent, team, system 是 Creator entity type
description string KB description
icon string KB icon
id string (uuid) 是 KB UUID
is_default boolean 是 Whether this is the default KB
is_personal boolean 是 Whether this is the owner's personal knowledge base (created by POST /api/v1/me/private-workspace)
name string 是 KB name
org_id string (uuid) 是 Organization UUID
owner_member_id string (uuid) Owner of a private knowledge base; only the owner and the owner's Agents can see it
status string: active, archived, trashed 是 KB status
storage_quota_bytes integer (int64) 是 Storage quota in bytes
trashed_at string (date-time) Trash time
updated_at string (date-time) 是 Last update time
visibility string: open, closed, private 是 KB visibility

KbSummaryItem

字段 类型 必填 说明
created_at string (date-time) 是 Creation time
creator_id string 是 Creator principal ID
creator_type string: user, agent, team, system 是 Creator entity type
description string KB description
icon string KB icon
id string (uuid) 是 KB UUID
is_default boolean 是 Whether this is the default KB
is_personal boolean 是 Whether this is the owner's personal knowledge base
last_modified_at string (date-time) Last content modification time
name string 是 KB name
org_id string (uuid) 是 Organization UUID
owner_member_id string (uuid) Owner of a private knowledge base; only the owner and the owner's Agents can see it
page_count integer (int64) 是 Page count
status string: active, archived, trashed 是 KB status
updated_at string (date-time) 是 Last update time
visibility string: open, closed, private 是 KB visibility

LastMessagePreviewItem

字段 类型 必填 说明
content string Message content
edited_at integer (int64) Edit timestamp
fallback_text string Fallback text preview
id integer (int64) 是 Message ID
sender_id string 是 Sender member ID
sender_type string 是 Sender type (human/agent/system)
timestamp integer (int64) 是 Message timestamp (unix ms)
type string 是 Message type (text/image/file/...)

LeaveGroupRequestBody

字段 类型 必填 说明
new_owner_id string (uuid) When the leaving member is the group owner, the human member to hand ownership to. Omit to let the platform pick a random remaining human member, or delete the group when only agents/nobody remain.

LeaveGroupResult

字段 类型 必填 说明
conversation_deleted boolean 是 True when the leave deleted the group (owner left with no human members remaining).
new_owner_id string The member the ownership was transferred to, when the leaving member was the owner.

ListAgentKnowledgeBasesResponseBody

字段 类型 必填 说明
data array of KbSummaryItem 是 Knowledge bases the Agent can read and the caller can read too
hidden_count integer (int32) 是 Knowledge bases the Agent can read but the caller cannot; only counted, never listed
pagination CursorMetadata 是 Pagination metadata; total_count excludes hidden_count
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

ListInvoiceableOrdersResponseBody

字段 类型 必填 说明
data array of InvoiceableOrderDTO 是 Response payload
pagination BillingPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

ListInvoicesResponseBody

字段 类型 必填 说明
data array of InvoiceHistoryDTO 是 Response payload
intl_invoice_enabled boolean 是 Effective international self-issued invoice switch (a deployment setting; off by default, always false on the China edition). While false, clients keep the billing list unchanged (as before international invoices) and ignore the international-invoice list fields
pagination BillingPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

ListMessageEditsResult

字段 类型 必填 说明
items array of MessageEditItem 是 Archived pre-edit revisions, oldest first

ListMessagesPagination

字段 类型 必填 说明
newer_cursor string Continue toward NEWER messages: pass this value as after_seq. Only returned for around_seq windows, and only when a newer message exists; absent otherwise.
next_cursor string 是 Continue toward OLDER messages: pass this value as before_seq. Empty string when no older message exists.
total_count integer (int64) Total number of matching items; omitted when the service does not compute a total

ListMessagesResponseBody

字段 类型 必填 说明
anchor_found boolean around_seq windows only: whether the anchor message itself still exists. A recalled message still exists (it is returned as a tombstone), so it reports true. False for a hard-deleted anchor (anchor_seq set, data holds its neighborhood) and for an around_seq that is not a position (anchor_seq absent, data holds the latest window, which is empty only for an empty conversation).
anchor_seq integer (int64) around_seq windows only: the seq the window is centered on. Present whenever that position exists in the conversation, including when the anchor message itself was hard-deleted. Absent when around_seq is not a position in this conversation (past its newest message); the window then falls back to the latest messages. Absence does not mean data is empty.
data array of MessageItem 是 Response payload
head_change_seq integer (int64) 是 The conversation's change-log head as of this response's data (including its reactions and card state). A client initializing its change watermark from this response has seen exactly the changes 1..head_change_seq; continue with list-conversation-changes since_change_seq=head_change_seq. 0 when the conversation has no change yet.
pagination ListMessagesPagination 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

ListMyInvitationsData

字段 类型 必填 说明
items array of MyInvitationItem 是 At most one invitation per organization (the newest), newest first. Empty when nothing is addressed to the caller's verified login emails.

ListOrdersResponseBody

字段 类型 必填 说明
current_inflight_plan_change InflightOrderDTO Order that holds the current plan-change single-flight slot, as selected by the billing system
data array of OrderHistoryDTO 是 Response payload
pagination BillingPageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

MarkMentionsReadRequestBody

字段 类型 必填 说明
message_ids array of string 是 Message ids whose @mention the caller has read. An empty list is a valid no-op. A non-numeric id is rejected outright rather than skipped, so the reported count can never be smaller than what the caller asked for.

MarkMentionsReadResult

字段 类型 必填 说明
marked integer (int64) 是 How many mentions this call actually flipped to read. Lower than the request when some were already read — the call is idempotent, not an error.

MarkReadRequestBody

字段 类型 必填 说明
read_until_seq integer (int64) 是 Read until sequence

MarkReadResult

字段 类型 必填 说明
read_until_seq integer (int64) 是 Read until sequence

MemberBatchResult

字段 类型 必填 说明
code string Stable error code when this member could not be removed
member_id string (uuid) 是 Member UUID
message string Human-readable reason when this member could not be removed
status integer (int64) 是 HTTP-equivalent status for this member
success boolean 是 Whether this member's removal was accepted. Read status to know whether it finished: 204 means the member is gone, 202 means the billing system accepted a platform Agent's teardown and the member is still there holding its slot. Counting success alone overstates how many seats or slots were freed.

MemberBatchSummary

字段 类型 必填 说明
duplicates integer (int64) 是 Duplicate member IDs skipped before execution
failed integer (int64) 是 Number of members that could not be removed
invalid integer (int64) 是 Blank member IDs skipped before execution
pending integer (int64) 是 Number of platform Agents whose teardown the billing system accepted but has not finished; they are still members and still hold their agent slot
success integer (int64) 是 Number of members removed
total integer (int64) 是 Number of member IDs in the request
unique_total integer (int64) 是 Unique non-blank member IDs processed

MemberDisplayInfo

字段 类型 必填 说明
avatar_url string Avatar URL
deleted boolean 是 True when the member has been removed from the organization. Its name is returned so historical reports can label it; it is no longer a member.
deleted_at string (date-time) When the member was removed; present only when deleted is true
display_name string 是 Last-known display name
kind string: human, agent, system 是 Member type
member_id string (uuid) 是 Member UUID
owner_member_id string (uuid) Owner member ID (for agent members)
status string: active, suspended, departed 是 Last-known member status. Presentation only — do not gate access on it.

MemberRole

字段 类型 必填 说明
display_name string 是 Human-readable role name
slug string 是 Role slug (e.g. org-owner, org-admin, org-member)

MemberSummary

字段 类型 必填 说明
agent_origin string: platform_created, external_invited Agent membership origin; omitted for non-agent members
agent_readiness string: provisioning, ready Platform agent provisioning readiness. 'provisioning' = creation still in flight, hold chat entry; 'ready' = has proved alive. OMITTED means the member is not subject to the provisioning gate — treat absent as not gated, never as not ready.
agent_type string Agent runtime type (e.g. hermes, claude_code); omitted for non-agent members
avatar_url string Avatar URL
billing_suspended boolean True when the agent is stopped by billing enforcement (arrears); false otherwise, including a credit-cap stop (see credit_cap_reached). Omitted when unknown.
billing_suspension_reason string Why billing stopped the agent, as reported by billing (e.g. insufficient_credits, agent_arrears). Omitted when not suspended or unknown.
credit_cap_reached boolean True when the effective stop reason is the agent credit cap (daily or monthly). Independent cap details are available from billing; omitted when not capped, unknown, or another restriction has priority.
display_name string 是 Display name
email string Email address (human members only)
identity_id string (uuid) 是 Identity UUID
joined_at string (date-time) 是 When the member joined the org
kind string: human, agent, system 是 Member type
locale string: en, zh Identity-level preferred language; omitted when unset (fallback: en)
member_id string (uuid) 是 Member UUID
online_status string: online, offline, unknown Online status (unknown if it cannot be determined)
owner_member_id string (uuid) Owner member ID (for agent members)
role MemberRole 是 Assigned role (single-role model)
status string: active, suspended, departed 是 Member status
subsystem_key string: approval_center, scheduler, notification_center, interaction_center Platform subsystem key (system members only); stable key for client-side name localization

MentionDisplayItem

字段 类型 必填 说明
is_mention_all boolean 是 Whether this mention came from @all/@all_agents expansion rather than a direct mention
mentioned_id string (uuid) 是 Mentioned member UUID
username string Display name captured at mention time (may be stale)

MentionInput

字段 类型 必填 说明
member_id string (uuid) Mentioned member UUID; required when type is member, ignored otherwise
type string: member, all, all_agents 是 Mention target type

MentionQueueEntryItem

字段 类型 必填 说明
is_mention_all boolean 是 false = named directly (@me); true = swept up by an @all expansion
message_id string 是 Message the @mention points at (string: the id is a BIGINT and must not become a JSON number)
sender_id string 是 Member id of whoever sent the mentioning message
sender_type string 是 Sender kind (human / agent / system)
seq integer (int64) 是 Conversation sequence of the mentioning message; the queue is ordered by this, not by timestamp
timestamp string (date-time) 是 Message timestamp, for display only

MentionQueueResult

字段 类型 必填 说明
mentions array of MentionQueueEntryItem 是 Unread @mentions, oldest first (by seq). May be shorter than the totals below when the page limit cuts in.
total_all integer (int64) 是 Unread @all mentions BEFORE the page limit. Kept separate from total_me because the button shows the count for the current type.
total_me integer (int64) 是 Unread direct (@me) mentions BEFORE the page limit. Render the badge from this, never from mentions.length.

MessageContentItem

字段 类型 必填 说明
attachments array of AttachmentItem Attachments
body object 是 Structured content body
content_type string 是 Content type, e.g. text, rich_text, image, file
token_usage TokenUsageItem Token usage

MessageEditItem

字段 类型 必填 说明
attachments array of AttachmentItem Archived attachments
body object 是 Archived content body
content_type string 是 Content type of the archived revision
created_at integer (int64) 是 When the edit happened (unix ms)
edited_by string 是 Member UUID that performed the edit
id string 是 Edit record UUID
message_id string 是 Message UUID
version integer (int32) 是 content_version the archived revision carried

MessageHighlight

字段 类型 必填 说明
field string 是 Matched field name
snippet string 是 Snippet with HTML em tags for highlighting; clients must escape when rendering to DOM

MessageItem

字段 类型 必填 说明
agent_run object Opaque agent run summary (agent execution visibility, schema_version 2) passed through from the stored message's agent_run. Producer-defined JSON object: render generically and ignore unknown keys. Present only on agent messages that carried one; omitted when absent and always omitted on recalled or deleted messages
attachments array of AttachmentItem Message attachments (image/file metadata)
card_body object The full card body in the cws.card.v1 card format (cws.card.v1 is the format identifier). A message list page may return card_preview with card_truncated=true instead; get the message to read card_body. Never present together with card_preview
card_expired boolean Whether the card interaction window expired; registered automation cards use their 24-hour consent window
card_preview object A shortened card in the cws.card.preview.v1 format (the format identifier) that a message list page may return instead of card_body, with card_truncated=true. It carries no kind=operation action; get the message for the full card
card_state CardStateItem Latest settled interaction on this card; absent when nobody has acted on it
card_superseded boolean Whether a later card replaces this one, including server-registered automation revisions
card_truncated boolean Whether card_preview was returned in place of card_body
chat_history_preview object CHAT_HISTORY messages only: a preview of a merged forward in the cws.chat_history.preview.v1 format (the format identifier): title, record_count and the first records, shortened. The full record list is content.body of get-message. Absent for every other type and for recalled messages.
client_msg_id string Sender-provided idempotency key, echoed on reads (optimistic reconciliation)
content string Raw JSON message content
content_version integer (int32) 是 Content version
conversation_id string (uuid) 是 Conversation UUID
created_at string (date-time) 是 Creation time
deleted_at string (date-time) Delete timestamp
edited_at string (date-time) Edit timestamp
fallback_text string Fallback text
id string 是 Message UUID
mentions array of MentionDisplayItem Mentions stored with the message, for rendering @-chips; omitted when the message has no mentions
metadata object Opaque message metadata passthrough; omitted when absent
org_id string (uuid) 是 Organization UUID
parent_id string Parent message ID (reply target)
priority integer (int32) 是 Message priority (1=urgent, 2=high, 3=normal); stamped server-side, always present
reactions array of ReactionAggregate Per-code reaction rollups; omitted when the message has no reactions
recalled_by string (uuid) Member UUID that recalled the message; presence marks the message as recalled (its content is redacted)
recalled_by_role string: sender, admin Whether the recall was performed by the original sender or a conversation admin/owner
sender_id string (uuid) 是 Sender member UUID
sender_type string: UNSPECIFIED, HUMAN, AGENT, SYSTEM 是 Sender type
seq integer (int64) 是 Conversation sequence
timestamp string (date-time) 是 Message timestamp
type string: UNSPECIFIED, TEXT, IMAGE, FILE, AUDIO, VIDEO, SYSTEM, AGENT_TEXT, AGENT_STRUCTURED, AGENT_CARD, AGENT_STREAM, CARD … 是 Message type

MessageSearchHitItem

字段 类型 必填 说明
highlights array of MessageHighlight Highlighted snippets
message MessageItem 是 Matched message
score number (float) 是 Relevance score

ModelCatalogData

字段 类型 必填 说明
models array of ModelCatalogEntry 是 Available models ordered by sort

ModelCatalogEntry

字段 类型 必填 说明
display_name string 是 Human-readable model name for UI display
family string 是 Stable model-family key used for selection and persistence (e.g. fable, opus, sonnet)
internal_only boolean When true, the model is restricted to admin operations and hidden from customer-facing interfaces
sort integer (int64) 是 Display order (ascending)

MoveIssueProjectRequestBody

字段 类型 必填 说明
new_project_id string (uuid) 是 New project UUID

MoveNodeRequestBody

字段 类型 必填 说明
parent_id string (uuid) New parent node UUID

MyInvitationItem

字段 类型 必填 说明
created_at string (date-time) 是 Invitation creation time
expires_at string (date-time) 是 Invitation expiry
invitation_id string (uuid) 是 Invitation UUID; pass it to POST /api/v1/me/invitations/{invitation_id}/accept
inviter_display_name string 是 Current member display name of whoever sent the invitation (also shown after they left the organization)
org_id string (uuid) 是 Inviting organization
org_name string 是 Current name of the inviting organization

MyProvisioningAgentSummary

字段 类型 必填 说明
agent_provisioning_stage string: runtime_down, runtime_up, session_ready, ready Provisioning-progress rung for the creation animation. On THIS endpoint it is 'ready' if and only if the agent is ready: a just-ready agent reports 'ready' even before its runtime does, and a still-provisioning agent never reports 'ready' early, even if its runtime does. So a client may key the completion frame off stage=='ready' here. Omitted when a still-provisioning agent has no reported stage.
avatar_url string Avatar URL
display_name string 是 Display name
member_id string (uuid) 是 Agent member UUID (drill-down target)

ObservationEdge

字段 类型 必填 说明
granted_at string (date-time) 是 When observation was granted
granted_by string 是 Grant source
observed_member_id string (uuid) 是 Observed member UUID
observer_member_id string (uuid) 是 Observer member UUID
org_id string (uuid) 是 Organization UUID

ObservationMember

字段 类型 必填 说明
avatar_url string Avatar URL
display_name string 是 Display name
kind string: human, agent 是 Member type
member_id string (uuid) 是 Member UUID
status string: active, suspended, departed 是 Member status

ObservedMemberItem

字段 类型 必填 说明
member ObservationMember 是 Observed member detail
observation ObservationEdge 是 Observation edge metadata

ObserverMemberItem

字段 类型 必填 说明
member ObservationMember 是 Observer member detail
observation ObservationEdge 是 Observation edge metadata

OrderCheckoutDTO

字段 类型 必填 说明
checkout_type string redirect (default; empty means redirect) | qr_code (checkout_url is QR content, render it) | jsapi (checkout_url is JSAPI params, do not navigate)
checkout_url string Cashier URL to resume payment; non-empty only when status=pending_payment and the handle is still live
payment_order_id string
status string 是 pending_payment (checkout_url live) | expired (handle dead — cancel the order and create a new one) | the order's current status otherwise

OrderFateDTO

字段 类型 必填 说明
biz_order_id string 是
created_at string (date-time)
failure_code string Set when status is a failed terminal state
order_type string 是 subscription|renewal|plan_change|credit_pack|agent_addon (agent_addon: an agent add-on purchase — its status carries the add-on lifecycle vocabulary, not the fiat-order one)
status string 是
updated_at string (date-time)

OrderHistoryDTO

字段 类型 必填 说明
amount_cents integer (int64) 是
billing_interval string Plan orders only
biz_order_id string 是
coupon_applied string
currency string 是
paid_at string (date-time)
provider_receipt_url string
sku_code string Product sku the order was placed for (e.g. the credit-pack sku); lets a client match a pending order back to the selected item
status string 是
type string 是 subscription|renewal|plan_change|credit_pack

OrgOwnerInfo

字段 类型 必填 说明
display_name string 是 Owner display name
member_id string (uuid) 是 Owner member UUID

OrganizationDeletionImpactDTO

字段 类型 必填 说明
category string 是 Data category the participant counted
count integer (int64) 是 Row count in that category
disposition string 是 What deletion would do with them (delete / retain_for_identity_policy / …)
participant string 是 Deletion participant service name

OrganizationDeletionPrecheckData

字段 类型 必填 说明
agents_count integer (int64) 是 Agents in the organization
blockers array of string 是 Conditions that currently block deletion, prefixed with the reporting participant
conversations_count integer (int64) 是 Conversations deletion would remove; null when the count is unavailable
credits_balance integer (int64) 是 Credit balance (points) deletion would forfeit; null when the balance is unavailable
impact array of OrganizationDeletionImpactDTO 是 Per-participant, per-category impact counts
org_id string (uuid) 是 Organization UUID
org_name string 是 Organization display name
subscription_plan string 是 Current subscription plan code; null when the org has no subscription
subscription_status string 是 Current subscription status (trialing/active/past_due/suspended/canceled); null when the org has no subscription

OrganizationDetail

字段 类型 必填 说明
created_at string (date-time) 是 Creation time
industry string 是 Organization industry key; null when never chosen
industry_other string 是 Free-text supplement for industry=other; null otherwise
member_count integer (int64) 是 Total active members
name string 是 Organization name
org_id string (uuid) 是 Organization UUID
owner OrgOwnerInfo Organization owner (org-owner role), if present
slug string 是 Organization slug
status string: active 是 Organization status

OrganizationSummary

字段 类型 必填 说明
created_at string (date-time) 是 Organization creation time
industry string 是 Organization industry key; null when never chosen
industry_other string 是 Free-text supplement for industry=other; null otherwise
member_id string (uuid) 是 Caller's member UUID in this org
name string 是 Organization name
org_id string (uuid) 是 Organization UUID
role_slug string 是 Caller's role slug in this org (e.g. org-owner)
slug string 是 Organization slug
status string: active 是 Organization status

OutstandingItemDTO

字段 类型 必填 说明
item_id string 是
kind string 是 arrears | restart_daily
period string 是 Period key (RFC3339)
points integer (int64) 是 Owed points for this item (= points_per_cycle; a single slot owes at most one period)
product_id string 是

OwnedAgentSummary

字段 类型 必填 说明
avatar_url string Avatar URL
display_name string 是 Display name
member_id string (uuid) 是 Agent member UUID (drill-down target)
model string Active runtime model display name; omitted when the agent has not reported runtime metrics
online_status string: online, offline, unknown Online status (unknown if it cannot be determined)

PageContentItem

字段 类型 必填 说明
additions integer (int32) Lines added
author_avatar_url string Author avatar URL
author_id string 是 Author principal ID
author_name string Author display name
author_type string: user, agent, team, system 是 Author entity type
body string 是 Page content body
created_at string (date-time) 是 Creation time
deletions integer (int32) Lines removed
front_matter object Parsed front matter
message string Revision message
org_id string (uuid) 是 Organization UUID
page_id string (uuid) 是 Page UUID
revision_id integer (int64) 是 Revision ID

PageItem

字段 类型 必填 说明
created_at string (date-time) 是 Creation time
creator_avatar_url string Creator avatar URL
creator_id string 是 Creator principal ID
creator_name string Creator display name
creator_type string: user, agent, team, system 是 Creator entity type
current_revision_id integer (int64) Current revision ID
format string: markdown, plain_text 是 Page format
id string (uuid) 是 Page UUID
kb_id string (uuid) 是 KB UUID
last_edited_by string Last editor principal ID
last_edited_by_type string: user, agent, team, system Last editor entity type
last_editor_avatar_url string Last editor avatar URL
last_editor_name string Last editor display name
org_id string (uuid) 是 Organization UUID
path string 是 Page path
status string: active, trashed 是 Page status
title string 是 Page title
trashed_at string (date-time) Trash time
updated_at string (date-time) 是 Last update time

PageListResponseApprovalItemBody

字段 类型 必填 说明
data array of ApprovalItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseAttemptItemBody

字段 类型 必填 说明
data array of AttemptItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseBlueprintItemBody

字段 类型 必填 说明
data array of BlueprintItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseInvitationSummaryBody

字段 类型 必填 说明
data array of InvitationSummary 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseIssueItemBody

字段 类型 必填 说明
data array of IssueItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseMemberSummaryBody

字段 类型 必填 说明
data array of MemberSummary 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseOrganizationSummaryBody

字段 类型 必填 说明
data array of OrganizationSummary 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseProjectItemBody

字段 类型 必填 说明
data array of ProjectItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseProjectMemberItemBody

字段 类型 必填 说明
data array of ProjectMemberItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseRoleItemBody

字段 类型 必填 说明
data array of RoleItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageListResponseTaskItemBody

字段 类型 必填 说明
data array of TaskItem 是 Response payload
pagination PageMetadata 是 Pagination metadata
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PageMetadata

字段 类型 必填 说明
page integer (int32) 是 Current page number
page_size integer (int32) 是 Number of items per page
total_count integer (int64) 是 Total number of matching items
total_pages integer (int32) 是 Total number of pages

PageReferenceItem

字段 类型 必填 说明
artifact_id string 是 Referenced artifact ID
display_name string 是 Reference display name
length integer (int32) 是 Reference length
offset integer (int32) 是 Reference offset
status string 是 Reference status

PatchConversationConnectorRequestBody

字段 类型 必填 说明
enabled boolean 是 Whether the connector is enabled for this conversation

PauseAgentRuntimeResponseBody

字段 类型 必填 说明
data AgentRuntimeCommandResult 是 Accepted runtime command result
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

PaymentMethodDTO

字段 类型 必填 说明
bound_at string (date-time) UTC creation instant of the verified payment credential; absent when no verified creation time is known
credential_id string
display_brand string
display_exp string
display_last4 string
id string 是
is_default boolean 是
method_type string 是 card|wechat|alipay
status string 是 pending_setup|active|expiring|expired|revoked|failed

PaymentMethodListDTO

字段 类型 必填 说明
methods array of PaymentMethodDTO 是

PlanStateDTO

字段 类型 必填 说明
addons array of AddonSummaryDTO 是
current_payment_method PaymentMethodDTO Display details of the subscription's payment credential, safe to show; absent when no verified credential is known
entitlements EntitlementsDTO
has_ever_paid_plan boolean 是 The org has ever paid for a plan subscription (credit packs do not count). A client shows the free-trial request entry exactly when !has_ever_paid_plan && subscription.status != trialing
is_paid_plan boolean 是 The org's current subscription is a paid plan (billing-computed)
subscription SubscriptionStateDTO
trial_eligible boolean 是 Org-level trial eligibility: a card subscription would get the 7-day trial. Clients apply the card-only condition themselves; submit-time validation remains authoritative
usage_snapshot UsageSnapshotDTO

PlatformAgentDomainAvailabilityData

字段 类型 必填 说明
available boolean 是 Whether the domain is available
domain string 是 Full domain assembled from the label and configured suffix
label string 是 Normalized subdomain label

PlatformAgentDomainConfigData

字段 类型 必填 说明
availability_check_label string 是 Human-readable availability check capability
availability_check_mode string: database 是 Current availability check capability
domain_binding_enabled boolean 是 Whether this deployment binds public domains to platform agents. true ⇒ global (binding available); false ⇒ China region (agent domain suffix not configured, binding disabled; clients should hide domain inputs/sections)
suffix string 是 Configured agent domain root suffix without a leading dot. Empty when domain binding is disabled (CN deployment)

PlatformAgentDomainData

字段 类型 必填 说明
full_domain string 是 Full public domain bound to the agent
label string 是 Subdomain label
root_suffix string 是 Configured agent domain root suffix

PlatformAgentOperationalStateDTO

字段 类型 必填 说明
actual_observed_at string (date-time) When the agent runtime observed actual_phase
actual_phase string: starting, online, stopping, offline, paused, error, unknown 是 Actual runtime phase observed from the agent runtime
addon_id string 是 Add-on ID; a stable key for the item
addon_status string 是 Current add-on status
available_actions array of string 是 Actions currently allowed for this caller, derived from the authoritative add-on status (active offers pause; paused/suspended offers resume). Withheld only while a conflicting operation is in flight (operation/phase set) or the required billing state is unavailable. Independent of the runtime actual_phase, which can degrade to unknown without withholding pause/resume.
credit_cap AgentCreditCapDTO
desired_phase string: online, paused, deleted, unknown 是 Desired runtime phase, owned by the billing system
failure string Machine-readable failure or required-action reason
identity_id string (uuid) Agent identity UUID; absent while creation has not produced an identity
member_id string (uuid) Agent member UUID; absent while creation has not produced a member
openmax_connection string: online, offline, unknown 是 Presence of the agent's messaging connection; independent from actual runtime phase
operation string: creating, pausing, resuming, deleting Current operation; absent when idle
phase string: in_progress, waiting_online, failed, action_required Current operation phase; absent when idle
requested_at string (date-time) When the current operation was requested
runtime_observation_availability string: available, unavailable, not_applicable Whether the agent runtime returned an observation; independent from the billing desired state
sku_code string 是 SKU code of the add-on
tier string 是 Agent add-on tier

PollAgentDingtalkScanData

字段 类型 必填 说明
binding AgentChannelBindingItem The pending DingTalk binding created by the shared connect path on a successful scan. Only set when status is "connected".
status string 是 Scan session status: pending | connected | expired | cancelled | error

PollAgentDingtalkScanRequestBody

字段 类型 必填 说明
session_handle string 是 The device code returned by the start-scan step

PollAgentFeishuScanData

字段 类型 必填 说明
binding AgentChannelBindingItem The pending Feishu binding created by the shared connect path on a successful scan. Only set when status is "connected".
status string 是 Scan session status: pending | connected | expired | cancelled | error

PollAgentFeishuScanRequestBody

字段 类型 必填 说明
session_handle string 是 The device code returned by the start-scan step

PollAgentLarkScanData

字段 类型 必填 说明
binding AgentChannelBindingItem The pending Lark binding created by the shared connect path on a successful scan. Only set when status is "connected".
status string 是 Scan session status: pending | connected | expired | cancelled | error

PollAgentLarkScanRequestBody

字段 类型 必填 说明
session_handle string 是 The device code returned by the start-scan step

PollAgentWecomScanData

字段 类型 必填 说明
binding AgentChannelBindingItem The pending WeCom binding created by the shared connect path on a successful scan. Only set when status is "connected".
status string 是 Scan session status: pending | connected | expired | cancelled | error

PollAgentWecomScanRequestBody

字段 类型 必填 说明
session_handle string 是 The scan code (scode) returned by the start-scan step

PrepareAvatarUploadInputBody

字段 类型 必填 说明
content_type string 是 Image MIME type: image/png, image/jpeg or image/webp
filename string 是 Original image filename (plain name, 1..255 characters)
size_bytes integer (int64) 是 Image size in bytes, 1..5242880 (5 MiB)

PrepareCommUploadRequestBody

字段 类型 必填 说明
content_type string 是 Content type
filename string 是 File name
size_bytes integer (int64) 是 File size in bytes

PrepareUploadItem

字段 类型 必填 说明
expires_at string (date-time) Upload URL expiration time
headers object 是 Headers required for upload
instant_upload boolean 是 Whether the upload can be finalized without uploading bytes
upload_token string 是 Opaque upload token
upload_url string 是 Presigned upload URL

PrepareUploadRequestBody

字段 类型 必填 说明
content_type string 是 Content type
filename string 是 File name
parent_id string (uuid) Parent folder node UUID
size_bytes integer (int64) 是 File size in bytes

PrepareUploadResult

字段 类型 必填 说明
expires_at string 是 When the upload expires
headers object 是 Upload headers
instant_upload boolean 是 Whether no upload body is required
upload_token string 是 Upload token
upload_url string 是 Upload URL

PreviewEventBindingRequestBody

字段 类型 必填 说明
anchor_at string (date-time) Interval phase anchor instant
cron_expr string Five-field cron expression, required for cron schedules
interval_seconds integer (int64) Elapsed interval in seconds
run_at string (date-time) Once trigger instant
schedule_kind string: cron, once, interval Schedule mode; omitted means cron
timezone string IANA timezone; omitted or empty applies no timezone

PrivateWorkspaceResult

字段 类型 必填 说明
created_knowledge_base boolean 是 True only for the call that created (or restored) the knowledge base
created_project boolean 是 True only for the call that created the project
knowledge_base KbItem 是 The caller's personal private knowledge base, bound to the project
project ProjectItem 是 The caller's personal private project

PrivateWorkspaceStatus

字段 类型 必填 说明
enabled boolean 是 Whether private projects and the personal workspace can be created now (automation_private_scope_enabled)
has_private_project boolean 是 Whether the caller owns or ever owned a private project; archived ones count

ProjectItem

字段 类型 必填 说明
archived_at string (date-time) Archive time
created_at string (date-time) 是 Creation time
description string 是 Project description
id string (uuid) 是 Project UUID
is_default boolean 是 Whether this is the default project for the organization
knowledge_base_id string (uuid) Knowledge base UUID
lead_member_id string (uuid) 是 Lead member UUID
name string 是 Project name
org_id string (uuid) 是 Organization UUID
owner_member_id string (uuid) Owner of a private project (also its fixed lead); absent for organization projects
scope string: org, private 是 org: visible per the organization's rules; private: only its owner and the owner's Agents that are members can see it
slug string 是 Project slug
starred boolean 是 Whether the authenticated caller has starred this project. Caller-relative and private to the caller; always false on create.
status string: active, archived 是 Project status
system_kind string: my_private my_private for the owner's personal private project created by POST /api/v1/me/private-workspace; absent otherwise
updated_at string (date-time) 是 Last update time

ProjectMemberItem

字段 类型 必填 说明
added_at string (date-time) 是 Project member add time
id string (uuid) 是 Project member UUID
member_id string (uuid) 是 Member UUID
project_id string (uuid) 是 Project UUID
role string: member, lead 是 Project member role

ProxyConnectForwardRequestBody

字段 类型 必填 说明
body any Request body
headers object Headers to forward
method string 是 HTTP method
url string 是 Target URL/path

QueryConnectAgentUsableConnectionsRequestBody

字段 类型 必填 说明
agent_member_ids array of string (uuid) 是 Agent member UUIDs, 1..50 as sent. Duplicates are collapsed (first occurrence keeps its position). An empty list, more than 50 ids or a malformed UUID rejects the whole request with 400.
statuses array of string: active, needs_reauth, error, expired, pending, revoked Connection status filter; a connection is returned when it matches any value. Omitted or empty = ["active"]. needs_reauth = status error WITH a pending re-authorization; error = status error WITHOUT one; the rest match the stored status. An unknown value rejects the whole request with 400.

QueryConnectApplicationsRequestBody

字段 类型 必填 说明
application_ids array of string (uuid) 是 Application UUIDs, 1..100 as sent. Duplicates (case-insensitive) are collapsed, the first occurrence keeping its position. An empty list, more than 100 ids or a malformed UUID rejects the whole request with 400.

Quota

字段 类型 必填 说明
auto_limit_bytes integer (int64) 是
auto_limit_reached boolean 是
capacity_bytes integer (int64) 是
increment_bytes integer (int64) 是
organization_id string 是
updated_at string (date-time) 是
used_bytes integer (int64) 是

ReactionAggregate

字段 类型 必填 说明
code string 是 Reaction code from the server-side reaction registry
count integer (int32) 是 Total number of reactors for this code
reacted_by_me boolean 是 Whether the authenticated caller has this reaction on the message
reactor_ids array of string Reactor member UUIDs (at most the first 20; count may exceed the list length)
unicode_fallback string 是 Unicode emoji rendered by clients that do not know the code

ReactionChangeResult

字段 类型 必填 说明
change_seq integer (int64) 是 Conversation change_seq this call allocated, so the acting device can advance its change watermark. 0 when nothing changed (idempotent no-op).

ReadCursorItem

字段 类型 必填 说明
last_ack_seq integer (int64) 是 Effective delivery watermark, folded to max(ack, read): messages with seq <= this value are delivered
last_read_seq integer (int64) 是 Messages with seq <= this value are read by the member
member_id string (uuid) 是 Conversation member (user or agent) UUID

ReadCursorsResult

字段 类型 必填 说明
cursors array of ReadCursorItem 是 Per-member cursor pairs, capped at 500 ordered by last_read_seq descending
member_count integer (int32) 是 True member count regardless of truncation
truncated boolean 是 True when the cursor list was capped below member_count

ReassignIssueOwnerRequestBody

字段 类型 必填 说明
new_owner_member_id string (uuid) 是 New owner member UUID

ReassignTaskRequestBody

字段 类型 必填 说明
new_assignee_id string (uuid) 是 New assignee member UUID

RecallMessageResult

字段 类型 必填 说明
change_seq integer (int64) 是 Conversation change_seq this recall allocated. 0 when nothing changed (a concurrent recall or delete won).

RenameEventBindingRequestBody

字段 类型 必填 说明
expected_version integer (int64) 是
title string 是 Automation title; at most 200 Unicode code points

RenameNodeRequestBody

字段 类型 必填 说明
name string 是 Tree node name

RequestInteractionRequestBody

字段 类型 必填 说明
agent_run object Optional opaque agent run summary attached to the card (agent execution visibility, schema_version 2). Kept unchanged, only for agent senders, only when its encoded size is at most 16 KiB and only while agent activity is enabled; otherwise it is dropped silently and the card is still sent.
choice ChoiceInteractionInput Required when interaction_type is choice
client_msg_id string Caller-generated dedup key for the send itself. At most 64 characters; a longer value is rejected.
form FormInteractionInput Required when interaction_type is form
interaction_type string: choice, form 是 Which kind of interaction this requests. The protocol reserves select_resource and domain_gate; an unknown value is refused here because this endpoint has to pick a variant for it.

ResolveConnectShopifyAppInstallRequestBody

字段 类型 必填 说明
ticket string 是 One-time claim ticket from the claim page URL (/connect/shopify/claim?ticket=...); not consumed

ResolveURIsData

字段 类型 必填 说明
failed array of string 是 URIs that could not be resolved
resolved object 是 Successfully resolved URIs

ResolveURIsRequestBody

字段 类型 必填 说明
inline boolean If true, return inline content-disposition URLs
uris array of string 是 List of artifact:// URIs to resolve

ResolvedURI

字段 类型 必填 说明
content_length integer (int64) 是 File size in bytes
content_type string 是 MIME type
download_url string 是 Download URL: a presigned storage URL, or, when download tickets are enabled, a short-lived platform URL (GET /api/public/artifacts/download/{ticket}) that redirects to one
expires_at string (date-time) 是 URL expiration time (the ticket expiry when download_url is a ticket URL)
name string 是 Original file name

RestartAgentRuntimeRequestBody

字段 类型 必填 说明
upgrade_image boolean When true, upgrade the agent to its latest resolved runtime image before restarting (heavier: teardown/recreate, running tasks may be lost). Default false = plain in-place restart.

RestartAgentRuntimeResponseBody

字段 类型 必填 说明
data AgentRuntimeCommandResult 是 Accepted runtime command result
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

ResumeAgentRuntimeResponseBody

字段 类型 必填 说明
data AgentRuntimeCommandResult 是 Accepted runtime command result
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp

ResumeIssueRequestBody

字段 类型 必填 说明
expected_plan_token string Optional current_plan_token of the plan the owner's feedback refers to (an empty string when the issue has no current_plan_token). Send it only to give feedback on an issue in pending_plan, only as the issue owner and with a non-empty reason; do not send it when resuming a delivered issue. With a token, a non-owner gets 403, a silent automation's or archived issue is refused, an issue not in pending_plan gets 412, and a plan that has changed since gets 412 WORK_ISSUE_PLAN_CHANGED. Omit for an ordinary resume; null is invalid
reason string Human feedback or reason for resuming work
source string Origin of the resume action (e.g. lead_chat)

RetryWebhookDeliveryRequestBody

字段 类型 必填 说明
expected_version integer (int64) 是

RevisionDiffItem

字段 类型 必填 说明
diff string 是 Revision diff
from_revision integer (int64) 是 Base revision ID
org_id string (uuid) 是 Organization UUID
page_id string (uuid) 是 Page UUID
to_revision integer (int64) 是 Target revision ID

RevisionSummaryItem

字段 类型 必填 说明
additions integer (int32) Lines added
author_id string 是 Author principal ID
author_type string: user, agent, team, system 是 Author entity type
created_at string 是 Creation time
deletions integer (int32) Lines removed
message string Revision message
org_id string (uuid) 是 Organization UUID
page_id string (uuid) 是 Page UUID
revision_id integer (int64) 是 Revision ID

RevokeApprovalRequestBody

字段 类型 必填 说明
reason string Revoke reason

RoleItem

字段 类型 必填 说明
description string 是 Role description
display_name string 是 Human-readable role name
is_builtin boolean 是 Whether this is a system-defined role
role_id string (uuid) 是 Role UUID
scope string: org, workspace 是 Role scope
slug string 是 Role slug (e.g. org-owner, workspace-member)

RunEventBindingRequestBody

字段 类型 必填 说明
confirm_paused boolean Explicit acknowledgement to run once while paused; does not resume scheduling
expected_version integer (int64) 是 Current configuration version
idempotency_key string 是 Stable key for retries of one manual run, scoped to this binding

RuntimeMetricsCost

字段 类型 必填 说明
daily number (double) Today's cumulative cost (USD)
session number (double) Current session cost (USD)
weekly number (double) This week's cumulative cost (USD)

RuntimeMetricsResources

字段 类型 必填 说明
cpu_pct number (double) CPU usage percentage
disk_alert_tier integer (int32) Highest disk usage alert tier crossed (80 or 90); read-only
disk_free_bytes integer (int64) Free disk space in bytes
disk_full boolean Whether write-full protection is active; read-only
disk_full_since string (date-time) When write-full protection started; read-only
disk_pct number (double) Disk usage percentage
disk_total_bytes integer (int64) Total disk size in bytes; derived from disk_free_bytes and disk_pct when omitted
mem_pct number (double) Memory usage percentage
mem_total_bytes integer (int64) Total memory in bytes
mem_used_bytes integer (int64) Used memory in bytes

RuntimeMetricsRuntime

字段 类型 必填 说明
context_pct number (double) Context window usage percentage
effort string Reasoning effort level
model string Active model display name
model_id string Active model identifier
state string Agent runtime state

SearchHitItem

字段 类型 必填 说明
accessible boolean 是 Whether the current caller can access this hit
author_id string 是 Author principal ID
author_type string 是 Author entity type
created_at string 是 Creation time
kb_id string (uuid) 是 KB UUID
org_id string (uuid) 是 Organization UUID
page_id string (uuid) 是 Page UUID
path string 是 Page path
snippet string 是 Search snippet
title string 是 Page title
updated_at string 是 Last update time

SearchMessagesRequestBody

字段 类型 必填 说明
cursor string Pagination cursor
limit integer (int32) Items per page (default: 20, max: 100)
query string 是 Search query

SendMessageRequestBody

字段 类型 必填 说明
agent_run object Optional opaque agent run summary (agent execution visibility, schema_version 2). Kept unchanged, only for agent senders, only when its encoded size is at most 16 KiB and only while agent activity is enabled; otherwise it is dropped silently and the message is still sent. Replaces the retired metadata.agent_run key, which is now stripped from metadata.
client_msg_id string 是 Client idempotency key. At most 64 characters; a longer value is rejected.
content MessageContentItem 是 Message content
fallback_text string Preview/fallback text — the short plaintext the conversation list shows for non-text messages. Required for card messages; omit and the platform derives it from the card body: the card title in black lenticular brackets (U+3010 / U+3011) followed by the summary. Capped at 8192 UTF-8 bytes by the platform.
mentions array of MentionInput Structured @mention targets. The platform does not parse @names from the message text; this array is the only mention source.
metadata object Optional metadata
parent_id string Parent message ID for reply
priority integer (int32) 1=urgent, 2=high, 3=normal; omit defaults to normal. In a DM to your own agent, normal is floored to high.
thread_id string (uuid) Thread UUID
ttl integer (int32) Time to live in seconds
type string: UNSPECIFIED, TEXT, IMAGE, FILE, AUDIO, VIDEO, SYSTEM, AGENT_TEXT, AGENT_STRUCTURED, AGENT_CARD, AGENT_STREAM 是 Message type

SendMessageResult

字段 类型 必填 说明
conversation_id string (uuid) 是 Conversation UUID
id string 是 Identifier of the stored message. Exception: when moderation.blocked is true nothing was stored and this is the synthetic placeholder "blocked-" — never a real message id and never usable for edit/reply/reaction/recall
moderation SendModeration Set only when the keyword filter blocked this (human) send; absent means it did nothing. When blocked, the message was withheld — never stored, never delivered to anyone — and nothing was posted in its place: id is the synthetic "blocked-" (never a real message id), seq is the conversation's last seq (none consumed; 0 in an empty conversation), timestamp is when it was blocked, and moderation.refusal_text is the refusal copy to show the sender as a system notice.
seq integer (int64) 是 Conversation sequence
timestamp string (date-time) 是 Message timestamp

SendModeration

字段 类型 必填 说明
blocked boolean 是 The human message was withheld (never stored, never delivered to anyone) and nothing was posted in its place
refusal_text string Set when blocked: the refusal copy to show the sender as a system notice (it has no sender)

SetAgentAvatarInputBody

字段 类型 必填 说明
avatar_url string 是 Avatar URL returned by POST /api/v1/avatars/uploads/finalize in this organization, or "" to restore the default avatar

SetAgentCapabilityTagsRequestBody

字段 类型 必填 说明
tags array of CapabilityTagInputDTO 是 Full replacement capability-tag set for the agent (declarative; the prior set is replaced)

SetAppBadgeItem

字段 类型 必填 说明
count integer (int64) The number to show, 1 to 1000000 (shown as 99+ above 99); 0 clears the badge. Give exactly one of count and dot
dot boolean true shows a dot without a number; false clears the badge. Give exactly one of count and dot
member_id string 是 The member the badge is for: a member id, as in user.member_id of the app token response

SetAppBadgesData

字段 类型 必填 说明
applied integer (int64) 是 Badges set for valid members (including writes that changed nothing, or that a stored badge with a later as_of outranked)
cleared integer (int64) 是 Badges cleared for valid members (count 0 or dot false)
skipped integer (int64) 是 Items whose member_id is not an active human member of the organization (Agents included); not told apart

SetAppBadgesRequestBody

字段 类型 必填 说明
app_id string The App ID (app_...), when not sent with HTTP Basic
app_secret string The App Secret, when not sent with HTTP Basic
as_of string (date-time) When the app computed these values (RFC 3339); a stored badge with a later as_of is kept (out of order protection). Defaults to the server clock; at most 5 minutes ahead of it
items array of SetAppBadgeItem 是 1 to 500 badges, one per member (a member_id at most once); more than 500 is a 422, an empty list a 400. Each sets the member's whole value for this app (set, not increment)
org_id string 是 The organization (UUID) whose installation of the app the badges are for; an official app installed in several organizations names one per request

SetGroupAllowFromRequestBody

字段 类型 必填 说明
allow_from array of string 是 Member UUIDs allowed to trigger the agent in this group

SetGroupAllowFromResponseBody

字段 类型 必填 说明
change_id string 是 Pending policy change ID; poll GET /api/v1/agents/{agent_member_id}/policy-changes/{change_id} for its outcome
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
status string: applying, applied, failed 是 Change status at write time; always applying on success (the agent has not confirmed it yet)

SetGroupModeRequestBody

字段 类型 必填 说明
mode string: smart, mention 是 Group response mode

SetGroupModeResponseBody

字段 类型 必填 说明
change_id string 是 Pending policy change ID; poll GET /api/v1/agents/{agent_member_id}/policy-changes/{change_id} for its outcome
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
status string: applying, applied, failed 是 Change status at write time; always applying on success (the agent has not confirmed it yet)

SetStepsRequestBody

字段 类型 必填 说明
steps array of StepInput 是 Replacement blueprint steps

SettleCardChoiceRequestBody

字段 类型 必填 说明
selected_action_ids array of string 是 Card-local ids of the chosen options. For selection_mode=single this is exactly one id.
selection_mode string 是 How many options the card accepts. The protocol reserves 'multiple'; the platform serves only 'single' today and fails closed on anything else.

SkillDTO

字段 类型 必填 说明
description string Skill description (for human and LLM semantic matching)
name string 是 Human-readable skill name
skill_id string 是 Skill identifier (Skill.id from the agent domain)

SpecStruct

字段 类型 必填 说明
description string Issue description; at most 1500 Unicode code points
knowledge_base_id string (uuid) Required exactly for knowledge_base_mode custom; must fit the project's scope (an organization project's automation cannot use a private knowledge base, a private one needs its owner's)
knowledge_base_mode string: project_default, custom, none Where runs store their outputs: project_default uses the project's knowledge base (for an unattached private automation, the Owner's personal private project's at run time), custom uses knowledge_base_id, none stores nothing in a knowledge base. Omitted on a create means project_default; an update that omits it (and knowledge_base_id) keeps the current choice, so send project_default to reset
project_id string (uuid) Project UUID; required unless unattached
title string 是 Issue title; at most 200 Unicode code points
unattached boolean The automation belongs to no project. With project_id omitted, unattached_scope chooses where it runs: the organization Inbox, or the Owner's hidden private project (created on first use; needs the Owner's private workspace). An update may name the project an earlier read returned. Omitted on a create means attached; an update that omits it keeps the current attachment, so send false to attach an unattached automation to project_id
unattached_scope string: org, private With unattached and no project_id: org (default) or private. A private one is created only by its Owner, whose own Agent leads it and joins through project_member_additions

StarItem

字段 类型 必填 说明
created_at string (date-time) 是 When the caller starred the object (kept on re-star)
object_id string 是 Id of the starred object in its owning service
object_type string 是 Object type: knowledge_base, automation, agent or connector

StarList

字段 类型 必填 说明
items array of StarItem 是 The caller's stars of the requested type, newest first. Not paginated: a soft cap of about 500 per type bounds it.

StartAgentDingtalkScanData

字段 类型 必填 说明
auth_url string 是 DingTalk authorization URL encoded in the QR (for rendering a custom QR or offering a fallback link)
expires_in_sec integer (int32) 是 How long the scan session is valid, in seconds (DingTalk device codes expire ~2 hours after generation)
qr_png_base64 string 是 Base64-encoded PNG of the QR code the user scans with the DingTalk app to authorize
session_handle string 是 DingTalk device code; the stateless, non-secret handle to pass back to the poll step
user_code string 是 Short user code the user can enter manually as a fallback to scanning the QR

StartAgentFeishuScanData

字段 类型 必填 说明
auth_url string 是 Feishu authorization URL encoded in the QR (for rendering a custom QR or offering a fallback link)
expires_in_sec integer (int32) 是 How long the scan session is valid, in seconds (Feishu device codes expire ~5 minutes after generation)
qr_png_base64 string 是 Base64-encoded PNG of the QR code the user scans with the Feishu app to authorize
session_handle string 是 Feishu device code; the stateless, non-secret handle to pass back to the poll step
user_code string 是 Short user code the user can enter manually as a fallback to scanning the QR

StartAgentLarkScanData

字段 类型 必填 说明
auth_url string 是 Lark authorization URL encoded in the QR (for rendering a custom QR or offering a fallback link)
expires_in_sec integer (int32) 是 How long the scan session is valid, in seconds (Lark device codes expire ~5 minutes after generation)
qr_png_base64 string 是 Base64-encoded PNG of the QR code the user scans with the Lark app to authorize
session_handle string 是 Lark device code; the stateless, non-secret handle to pass back to the poll step
user_code string 是 Short user code the user can enter manually as a fallback to scanning the QR

StartAgentWecomScanData

字段 类型 必填 说明
auth_url string 是 WeCom authorization URL encoded in the QR (for rendering a custom QR or offering a fallback link)
expires_in_sec integer (int32) 是 How long the scan session is valid, in seconds (WeCom scodes expire ~5 minutes after generation)
qr_png_base64 string 是 Base64-encoded PNG of the QR code the user scans with the WeCom app to authorize
session_handle string 是 WeCom scan code (scode); the stateless, non-secret handle to pass back to the poll step

StartAgentWhatsappBusinessRegistrationData

字段 类型 必填 说明
binding AgentChannelBindingItem 是 The pending WhatsApp Business binding created/updated by step 1
masked_number string 是 Display-only, partially-masked rendering of the number (e.g. "+1 ******4567") for confirmation UIs
phone_number_id string 是 Meta Graph id of the added number; the stateless session handle to pass back to the submit-code step (not secret)

StartAgentWhatsappBusinessRegistrationRequestBody

字段 类型 必填 说明
cc string 是 Country calling code (1-4 digits), e.g. "1"
code_method string OTP delivery method: sms | voice (case-insensitive; empty defaults to sms)
display_name string Business display name shown on WhatsApp (Meta verified_name, 1-75 chars)
phone_number string 是 National number without the country code (4-15 digits)

StartTaskData

字段 类型 必填 说明
attempt AttemptItem 是 Created attempt
task TaskItem 是 Started task

StepInput

字段 类型 必填 说明
depends_on_temp_ids array of string Temporary dependency step IDs
description string 是 Step description
required_resources object Required resources JSON object
temp_id string 是 Temporary step ID

SubConversationOwnerInput

字段 类型 必填 说明
app_id string See kind. Never used to pick the owner.
kind string: app, platform Ignored for app access tokens (the owner is always the token's app). Other callers act as the platform: omit it or send platform; naming an app is refused with 403 SUBCONVERSATION_OWNER_NOT_ALLOWED.

SubConversationResult

字段 类型 必填 说明
conversation ConversationItem 是 The sub-conversation (never its parent)
created boolean 是 Whether a new sub-conversation was created

SubmitAgentWhatsappBusinessCodeData

字段 类型 必填 说明
binding AgentChannelBindingItem 是 The WhatsApp Business binding, now connected
inbound_enabled boolean 是 Whether the per-number webhook override was applied. False when the resolved webhook base URL was empty or the override call failed (non-blocking); the binding is still connected but inbound routes to the app-level webhook.

SubmitAgentWhatsappBusinessCodeRequestBody

字段 类型 必填 说明
code string 是 Verification code the user received (4-8 digits). Never stored or logged.
phone_number_id string 是 The stateless session handle returned by the start-registration step
webhook_base_url string Optional explicit webhook base URL override. When empty the platform resolves it from the agent's bound platform domain; when neither is present the number is connected with inbound disabled.

SubmitCardInteractionRequestBody

字段 类型 必填 说明
action CardActionSubmitInput Required when interaction_type is action
choice CardChoiceSubmitInput Required when interaction_type is choice
form CardFormSubmitInput Required when interaction_type is form
interaction_type string: choice, form, action 是 Which kind of card interaction this is; selects the one payload object that must accompany it.

SubmitIssuePlanRequestBody

字段 类型 必填 说明
blueprint_id string (uuid) 是 Blueprint UUID for the submitted execution plan
card_message_id string (uuid) Optional IM card message UUID
plan_text string 是 Markdown plan text shown to the human for confirmation
source string Origin of the plan request (e.g. lead_chat, text_card_proxy)

SubscriptionIntentReadDTO

字段 类型 必填 说明
amount_due_cents integer (int64) 是
billing_interval string month|quarter|year
checkout CheckoutHandleDTO
currency string 是
expires_at string (date-time) Intent expiry (created_at + TTL); non-null only for the TTL-bearing form (a subscription created bare order without a trial handle), null for exempt/dispatched forms
intent_id string 是 = biz_order_id (the intent head's current order)
next_step string 是 checkout|trial_setup|zero_amount_done|zero_amount_done_setup_pending|already_settled (idempotent replay hit an already-settled order — terminal success, no checkout handle)|processing (GET-only: an in-flight order the client polls, never an error)
payment_method string card|wechat|alipay; may be empty when the method is chosen at checkout — not a reliable match key
plan_code string The plan this intent is for (target_ref)
subscription_status string
trial_eligible boolean 是
trial_end string (date-time)

SubscriptionStateDTO

字段 类型 必填 说明
activation_order_id string Current contract activation identity; use with plan_version for Admin custom termination preconditions
allow_self_purchase boolean 是 Whether this custom-plan policy permits user-initiated credit-pack purchases
auto_renew boolean 是
auto_renew_off_reason string user_cancel|setup_pending|setup_failed|no_credential. Empty when auto_renew is on, for one_time payment methods, on Free, or when no reason is known. setup_pending is the only user-resolvable cause.
billing_interval string 是 month|quarter|year
can_cancel boolean 是 Server-owned capability for canceling the current subscription
can_change_plan boolean 是 Server-owned capability for changing the current plan
can_manage_auto_topup boolean 是 Server-owned capability for managing automatic credit top-up
can_manage_credit_payment_methods boolean 是 Server-owned capability for saved payment methods used in self-purchased credits; does not authorize subscription renewal or auto-top-up
can_manage_payment boolean 是 Server-owned capability for managing subscription payment methods
carried_coupon_code string
carried_coupon_duration string one_time|first_n_cycles|forever
carried_coupon_duration_cycles integer (int32) Cycle count when carried_coupon_duration is first_n_cycles
credential_id string Exact credential pinned for future renewal; never infer it from the default or newest payment method
currency string 是
current_cycle_grant_points integer (int64) Authoritative quota for the current custom-plan grant cycle; not wallet balance or proof of settlement
current_period_end string (date-time)
current_period_start string (date-time)
custom_plan boolean 是
free_fallback_reason string renewal_failed|trial_expired. Empty for a deliberate Free choice, a planned period-end downgrade, or when no reason is known.
managed_started_at string (date-time) Original admin-managed activation time; absent when the billing system cannot establish it, never inferred from the rolling billing period
managed_until string (date-time) Administrative service cutoff for an admin_managed subscription
next_charge_amount_cents integer (int64) Minor units (cents). What the next charge will be, from the same target resolution and coupon carry the charge itself uses — including a mid-trial pending plan change. Present only on GET /billing/plan-state; absent elsewhere. A present 0 is a real amount (100%-off carried coupon), so do not treat 0 as missing. Caveat: an active subscription's recurring coupon is not yet reflected, and a canceled / auto_renew=false subscription still reports a figure although nothing will be collected.
next_cycle_grant_points integer (int64) Quota scheduled for the next custom-plan grant cycle; changing it does not issue or reclaim current Credits
next_grant_at string (date-time) Authoritative next monthly grant boundary; distinct from a quarterly or annual payment-period end
payment_method string Exact method family pinned for future renewal: card|alipay|wechat; may be empty when no method is pinned
pending_billing_interval string
pending_change_at string (date-time)
pending_change_revision string 是 Opaque decimal int64 revision; preserve with the raw pending fields when cancelling a scheduled change
pending_plan_code string
plan_code string 是
plan_name string 是
plan_version integer (int32) 是
price_id string 是
renewal_mode string 是 psp|admin_managed; server-owned renewal lifecycle
status string 是 trialing|active|past_due|suspended|canceled
trial_end string (date-time)
unit_amount_cents integer (int64) 是 Minor units (cents)

SyncCommRequestBody

字段 类型 必填 说明
device_id string 是 Device ID
limit integer (int32) Maximum events to return
since_seq integer (int64) 是 Last seen sync sequence

SyncEventItem

字段 类型 必填 说明
conversation_id string (uuid) 是 Conversation UUID
message_id integer (int64) 是 Message ID
seq integer (int64) 是 Sync sequence
timestamp string (date-time) 是 Event timestamp

SyncResult

字段 类型 必填 说明
events array of SyncEventItem 是 Sync events
has_more boolean 是 Whether more events are available
next_cursor string 是 Decimal string cursor for the next sync: a monotonically increasing positive integer. Send it back unchanged as since_seq and only compare it for ordering; never derive it from event seq values. It can be greater than the seq of the last event on this page.

TaskItem

字段 类型 必填 说明
archived_at string (date-time) Archive time inherited from the project
assignee_id string (uuid) Assignee member UUID
assignee_status string: active, suspended, departed Current membership status of the assignee
blueprint_step_id string (uuid) Blueprint step UUID
created_at string (date-time) 是 Creation time
current_attempt_number integer (int32) 是 Current attempt number
depends_on array of string (uuid) Task dependency UUIDs
description string 是 Task description
finished_at string (date-time) Finish time
id string (uuid) 是 Task UUID
issue_id string (uuid) 是 Issue UUID
org_id string (uuid) 是 Organization UUID
project_id string (uuid) 是 Project UUID
started_at string (date-time) Start time
status string: pending, assigned, running, done, failed, cancelled 是 Task status
title string 是 Task title
updated_at string (date-time) 是 Last update time

TerminateIssueRequestBody

字段 类型 必填 说明
reason string Why the issue is being terminated
source string Origin of the terminate action (e.g. lead_chat, ui)

TimezonesData

字段 类型 必填 说明
timezones array of string 是 Sorted list of selectable IANA timezone names (e.g. Asia/Shanghai) plus UTC: the zones of inhabited regions, without historical aliases or placeholder names (e.g. Japan, US/Pacific, Zulu)

TokenUsageItem

字段 类型 必填 说明
cache_read integer (int32) Cache-read tokens
input integer (int32) 是 Input tokens
output integer (int32) 是 Output tokens

TransitionAttemptRequestBody

字段 类型 必填 说明
blocked_on_approval_request_ids array of string (uuid) Blocked approval request UUIDs
failure_reason string Failure reason
target_status string: done, failed, blocked, cancelled 是 Terminal target attempt status

TransitionTaskRequestBody

字段 类型 必填 说明
target_status string: done, failed, cancelled 是 Terminal target task status

TreeNodeItem

字段 类型 必填 说明
artifact_id string (uuid) Artifact UUID
created_at string (date-time) 是 Creation time
creator_avatar_url string Creator avatar URL
creator_id string Creator principal ID
creator_name string Creator display name
creator_type string: user, agent, team, system Creator entity type
external_ref string External reference
id string (uuid) 是 Tree node UUID
kb_id string (uuid) KB UUID
name string 是 Node name
node_type string: folder, page, file 是 Node type
org_id string (uuid) 是 Organization UUID
page_id string (uuid) Page UUID
parent_id string (uuid) Parent node UUID
sort_order integer (int32) 是 Sort order
source_ref string Source reference
updated_at string (date-time) 是 Last update time

TreeNodeWithChildrenItem

字段 类型 必填 说明
children array of TreeNodeWithChildrenItem 是 Nested children
children_count integer (int32) 是 Child count
node TreeNodeItem 是 Tree node

UnreadCountResult

字段 类型 必填 说明
unread integer (int64) 是 Unread count

UpdateAgentChannelCredentialsRequestBody

字段 类型 必填 说明
config object 是 Updated channel form values keyed by field key. Sensitive values are forwarded to the agent runtime and are never persisted or logged by the platform.

UpdateAgentModelRequestBody

字段 类型 必填 说明
model string 是

UpdateAgentModelVisibilityRequestBody

字段 类型 必填 说明
visible boolean 是

UpdateAgentPolicyRequestBody

字段 类型 必填 说明
dm_allowlist array of string Complete target DM allowlist (member UUIDs); omitted = not changed, [] = clear
dm_policy string: open, allowlist, owner DM access policy; omitted = not changed
group_allowlist array of string Complete target group allowlist (conversation UUIDs); omitted = not changed, [] = clear
group_scope string: open, allowlist, disabled Group access scope; omitted = not changed

UpdateAgentPolicyResponseBody

字段 类型 必填 说明
change_id string 是 Batch change ID; poll GET /api/v1/agents/{agent_member_id}/policy-changes/{change_id} for its outcome
items array of string 是 Items in this batch, in the fixed order dm_policy, dm_allowlist, group_scope, group_allowlist (only the ones the request carried)
request_id string (uuid) 是 Request trace ID
server_time string (date-time) 是 Server timestamp
status string: applying, applied, failed 是 Change status at write time; always applying on success (the agent has not confirmed it yet)

UpdateConnectApplicationActionDefRequestBody

字段 类型 必填 说明
encoding string Request body encoding
headers object Header template; non-empty replaces stored headers, empty leaves unchanged
input_schema string JSON schema for action inputs
method string HTTP method
request_spec any Optional request_spec JSON object; present replaces the stored one (cannot be cleared via update). Validated by the platform
url_template string URL template

UpdateConnectApplicationRequestBody

字段 类型 必填 说明
api_key_header_name string API key header/param name
api_key_location string API key location: header or query
category string Category
connector_kind string Connector transport kind (read-only after create; accepted but not applied on update)
description string Description
display_name string Display name
icon_url string Icon URL
is_enabled boolean Whether the application is enabled
oauth_authorize_url string OAuth authorize URL (unset leaves unchanged)
oauth_client_id string OAuth client ID (unset leaves unchanged)
oauth_client_secret string OAuth client secret (empty/absent leaves the stored secret unchanged; non-empty overwrites)
oauth_pkce boolean Whether OAuth uses PKCE
oauth_scopes_default array of string Default OAuth scopes (absent leaves unchanged; present replaces, empty clears)
oauth_token_auth_method string OAuth token auth method: basic or post
oauth_token_body_format string OAuth token body format: form or json
oauth_token_url string OAuth token URL (unset leaves unchanged)

UpdateConnectConnectionRequestBody

字段 类型 必填 说明
display_name string 是 Connection display name
mcp_headers array of ConnectMcpHeaderInput Full-replace custom-header set for a remote_http MCP connection: each {name, value, is_secret}. Omit to leave headers unchanged; send (even an empty array) to replace the full set. An is_secret=true entry with an empty value keeps the existing stored secret. Validated server-side.

UpdateEventBindingRequestBody

字段 类型 必填 说明
anchor_at string (date-time) Interval phase anchor instant
authorization_card_interaction_id string (uuid)
authorization_confirmation_message_id string
authorization_proposal_message_id string
cron_expr string Five-field cron expression, required for cron schedules
expected_version integer (int64) 是 Current binding version for optimistic concurrency control
interval_seconds integer (int64) Elapsed interval in seconds
lead_member_id string (uuid) 是 Lead agent member UUID
owner_member_id string (uuid) Human Owner UUID; omitted defaults to the human caller, not the previous owner. Agent callers require an explicit human Owner; the server enforces authorization
project_member_additions array of string Members added to spec.project_id atomically with this write: only lead_member_id and/or owner_member_id, each once. The acting human (caller, or the confirming human for Agent writes) needs project write access. Must be empty for the Inbox. A non-empty list also resumes an automation paused for LEAD_PROJECT_ACCESS_REQUIRED or OWNER_PROJECT_ACCESS_REQUIRED once every dependency validates. Where resume-on-save is enabled on the deployment, any save by the Owner (direct, or confirmed in chat) that passes every check resumes an automation paused for LEAD_PROJECT_ACCESS_REQUIRED, OWNER_PROJECT_ACCESS_REQUIRED, MEMBER_UNAVAILABLE, PRIVATE_LEAD_OWNER_CHANGED or PROJECT_UNAVAILABLE, with or without this list; never a manual pause, and an elapsed single run stays paused. Read enabled and pause_reason in the response
result_notification_policy string: every, failure_only, none Omitted preserves the current policy and migration notice; an explicit enum value clears the notice, even when unchanged. HTTP null is tolerated as omission
run_at string (date-time) Once trigger instant
schedule_kind string: cron, once, interval Replacement schedule mode; omitted means cron
spec UpdateEventBindingSpec 是 Complete issue specification to replace the current configuration; an omitted knowledge base choice (knowledge_base_mode with knowledge_base_id) or unattached keeps the current one
timezone string 是 Required for full replacement, unlike create. IANA timezone, or an explicit empty string to apply no timezone; does not retain the previous timezone

UpdateEventBindingSpec

字段 类型 必填 说明
description string Issue description; at most 1500 Unicode code points; omitted or empty clears the current description
knowledge_base_id string (uuid) Required exactly for knowledge_base_mode custom; must fit the project's scope (an organization project's automation cannot use a private knowledge base, a private one needs its owner's)
knowledge_base_mode string: project_default, custom, none Where runs store their outputs: project_default uses the project's knowledge base (for an unattached private automation, the Owner's personal private project's at run time), custom uses knowledge_base_id, none stores nothing in a knowledge base. Omitted on a create means project_default; an update that omits it (and knowledge_base_id) keeps the current choice, so send project_default to reset
project_id string (uuid) Target project UUID; required unless unattached
title string 是 Issue title; at most 200 Unicode code points
unattached boolean The automation belongs to no project. With project_id omitted, unattached_scope chooses where it runs: the organization Inbox, or the Owner's hidden private project (created on first use; needs the Owner's private workspace). An update may name the project an earlier read returned. Omitted on a create means attached; an update that omits it keeps the current attachment, so send false to attach an unattached automation to project_id
unattached_scope string: org, private With unattached and no project_id: org (default) or private. A private one is created only by its Owner, whose own Agent leads it and joins through project_member_additions

UpdateGroupConversationRequestBody

字段 类型 必填 说明
avatar_media_id string Avatar media UUID
description string Group description
name string Group name

UpdateIssueRequestBody

字段 类型 必填 说明
description string Update issue description
priority string: low, medium, high Update issue priority
title string Update issue title

UpdateKBRequestBody

字段 类型 必填 说明
description string KB description
icon string KB icon
name string KB name
set_description boolean Set to true to apply description, or clear it when description is omitted
set_icon boolean Set to true to apply icon, or clear it when icon is omitted
visibility string: open, closed, private KB visibility

UpdateMeData

字段 类型 必填 说明
avatar_url string Avatar URL
contact_email string UNVERIFIED contact email after the update; omitted when unset or just cleared. Never used for authentication or verification.
created_at string (date-time) 是 Identity creation time
display_name string 是 Display name
identity_id string (uuid) 是 Identity UUID
kind string: human, agent 是 Identity type
locale string: en, zh Identity-level preferred language; omitted when unset
phone_cc string Primary phone country calling code (digits only, no +); omitted when unset
phone_number string Primary phone national number (without country code); omitted when unset

UpdateMeRequestBody

字段 类型 必填 说明
avatar_url string Avatar URL from POST /api/v1/avatars/uploads/finalize in the current organization, or "" to restore the default avatar
contact_email string Update the UNVERIFIED contact email on the caller's own identity. Send a valid address to set it; send an empty string to CLEAR it. Omitting the field (or sending JSON null, which is indistinguishable from omitted) leaves the stored value unchanged. Invalid non-empty values are rejected with 400. This never becomes a login or verification address — see the contact_email field on the response.
display_name string Update display name
locale string: en, zh Update identity-level preferred language (org independent)
phone_cc string Update primary phone country calling code (digits only, no +, 1-4 digits). Must be sent together with phone_number.
phone_number string Update primary phone national number (digits only, 4-15). Must be sent together with phone_cc.

UpdateMemberDisplayNameData

字段 类型 必填 说明
display_name string 是 Org-level member display name

UpdateMemberDisplayNameRequestBody

字段 类型 必填 说明
display_name string 是 Org-level member display name

UpdateMemberRequestBody

字段 类型 必填 说明
avatar_url string Avatar URL from POST /api/v1/avatars/uploads/finalize in this organization, or "" to restore the default avatar
display_name string Change org-level member display name
role_id string (uuid) Change member role (single-role model)
status string: active, suspended Change member status (active or suspended only; departed requires DELETE)

UpdateMemberResponseBody

字段 类型 必填 说明
avatar_url string Avatar URL
display_name string 是 Display name
identity_id string (uuid) 是 Identity UUID
joined_at string (date-time) 是 When the member joined the org
kind string: human, agent, system 是 Member type
member_id string (uuid) 是 Member UUID
online_status string: online, offline, unknown Online status (unknown if it cannot be determined)
request_id string (uuid) 是 Request trace ID
role MemberRole 是 Current role after update (single-role model)
server_time string (date-time) 是 Server timestamp
status string: active, suspended, departed 是 Member status

UpdateOrganizationData

字段 类型 必填 说明
industry string 是 Organization industry key; null when never chosen
industry_other string 是 Free-text supplement for industry=other; null otherwise
name string 是 Updated name
org_id string (uuid) 是 Organization UUID
slug string 是 Updated slug
status string: active 是 Organization status

UpdateOrganizationRequestBody

字段 类型 必填 说明
industry string: retail_ecom, b2b_trade, content_media, consumer_brand, logistics, manufacturing, other Update the organization industry key. Switching to a value other than 'other' clears industry_other. Existing agents are not renamed.
industry_other string Update the free-text supplement; only valid when the resulting industry is 'other'. Blank clears it; omitted keeps the stored text while the industry stays 'other'.
name string Update organization name
slug string Update organization slug (globally unique)

UpdatePageContentRequestBody

字段 类型 必填 说明
auto_save boolean 是 Whether this is an autosave update
base_revision_id integer (int64) Expected base revision ID
body string 是 Page content body
message string Revision message

UpdatePageMetadataRequestBody

字段 类型 必填 说明
title string Page title

UpdateProjectRequestBody

字段 类型 必填 说明
description string Update project description
knowledge_base_id string (uuid) Update default knowledge base for new issues; existing issues retain their knowledge base
lead_member_id string (uuid) Update lead member UUID
name string Update project name

UpdateSubConversationRequestBody

字段 类型 必填 说明
title string 是 New display title; empty clears it.

UpdateWebhookRequestBody

字段 类型 必填 说明
authorization_card_interaction_id string (uuid)
authorization_confirmation_message_id string
authorization_proposal_message_id string
event_filter string Optional bounded CEL boolean expression over payload; empty matches all
expected_version integer (int64) 是
lead_member_id string (uuid) 是
owner_member_id string (uuid) Human Owner UUID; omitted defaults to the human caller, not the previous owner. Agent callers require an explicit human Owner
project_member_additions array of string Members added to spec.project_id atomically with this write: only lead_member_id and/or owner_member_id, each once. The acting human (caller, or the confirming human for Agent writes) needs project write access. Must be empty for the Inbox. A non-empty list also resumes an automation paused for LEAD_PROJECT_ACCESS_REQUIRED or OWNER_PROJECT_ACCESS_REQUIRED once every dependency validates. Where resume-on-save is enabled on the deployment, any save by the Owner (direct, or confirmed in chat) that passes every check resumes an automation paused for LEAD_PROJECT_ACCESS_REQUIRED, OWNER_PROJECT_ACCESS_REQUIRED, MEMBER_UNAVAILABLE, PRIVATE_LEAD_OWNER_CHANGED or PROJECT_UNAVAILABLE, with or without this list; never a manual pause, and an elapsed single run stays paused. Read enabled and pause_reason in the response
result_notification_policy string: every, failure_only, none Omitted preserves the current policy and migration notice; an explicit enum value clears the notice, even when unchanged. HTTP null is tolerated as omission
spec UpdateEventBindingSpec 是

UsageCredentialMetadataBody

字段 类型 必填 说明
data UsageCredentialMetadataData 是
request_id string 是
server_time string (date-time) 是

UsageCredentialMetadataData

字段 类型 必填 说明
credential Credential 是

UsageSnapshotDTO

字段 类型 必填 说明
agent_slots_total integer (int64) 是
agent_slots_used integer (int64) 是
credit_as_of string (date-time)
credit_balance integer (int64) 是
credit_breakdown CreditBreakdownDTO
credit_pending integer (int64) 是
enforcement_suspended boolean 是 true when the org's LLM usage is currently stopped by the engine for non-payment
members_total integer (int64) 是
members_used integer (int64) 是
outstanding_points integer (int64) 是 Current charge debt awaiting deduction; credit_balance remains nonnegative
paid_balance integer (int64) 是 Purchase/subscription grant remaining (points)
period_consumed_points integer (int64) 是 Net points consumed this billing period; used% = consumed/(consumed+credit_balance)
promo_balance integer (int64) 是 Trial/promo grant remaining (points); during a trial this IS the trial remaining

UsageSummaryBucketDTO

字段 类型 必填 说明
bucket_start string (date-time) 是 Bucket start, truncated to the requested granularity (UTC)
model string 是 Resource/model the usage was metered against
points_micro integer (int64) 是 Billed points ×1e6
quantity integer (int64) 是 Raw metered quantity, counted in the unit reported by unit (NOT always tokens)
unit string 是 Unit code for quantity: token | minute | request; empty = unit unknown (show the number without a unit, never guess one)
usage_type string 是 Usage-type code: request (one entry per request) | input|output|cache_read (per-token usage; these three appear only on earlier usage, current usage is reported as request) | agent_runtime_hourly (Agent runtime). Machine-readable; render an unknown code as-is.

UsageSummaryDTO

字段 类型 必填 说明
buckets array of UsageSummaryBucketDTO 是

UserConversationItem

字段 类型 必填 说明
conversation ConversationItem 是 Conversation
has_unread_subconversations boolean 是 Whether the caller has an unread message in at least one unarchived context sub-conversation under this conversation (the dot on its sub-conversation entry). Not included in unread_count; always false on observed rows.
is_done boolean Whether the conversation is marked as done; omitted for observed conversations
is_muted boolean Whether the conversation is muted; omitted for observed conversations
is_observed boolean 是 Whether this row is visible through observation
is_pinned boolean Whether the conversation is pinned; omitted for observed conversations
last_read_seq integer (int64) Last read sequence; omitted for observed conversations
observed_member_ids array of string 是 Observed member IDs that make this visible
pin_order integer (int32) Pin order; omitted for observed conversations
unread_count integer (int64) 是 Unread count
unread_mention string: none, direct, all 是 Unread @mention badge state. direct wins over all when both are unread; always none on observed rows.

WebhookConfiguration

字段 类型 必填 说明
authorization_card_interaction_id string (uuid)
authorization_confirmation_message_id string
authorization_proposal_message_id string
event_filter string Optional bounded CEL boolean expression over payload; empty matches all
lead_member_id string (uuid) 是
owner_member_id string (uuid) Human Owner UUID; omitted defaults to the human caller. Agent callers require an explicit human Owner
project_member_additions array of string Members added to spec.project_id atomically with this write: only lead_member_id and/or owner_member_id, each once. The acting human (caller, or the confirming human for Agent writes) needs project write access. Must be empty for the Inbox
result_notification_policy string: every, failure_only, none Final result DM policy; omitted webhook creates default to failure_only. HTTP null is tolerated as omission
spec UpdateEventBindingSpec 是

WebhookCredential

字段 类型 必填 说明
binding EventBindingItem 是
credential_version integer (int64) 是
event_filter string 是
webhook_url string 是 Secret URL returned only on creation, timer-to-webhook replacement, or rotation; never persist in browser storage

WebhookCredentialResponseBody

字段 类型 必填 说明
data WebhookCredential 是
request_id string 是
server_time string (date-time) 是

WebhookDeliveryItem

字段 类型 必填 说明
attempt_count integer (int32) 是
created_issue_id string
error_code string
event_binding_id string 是
id string 是
occurrence_id string
received_at string (date-time) 是
replay_state string: held, replay, declined, excluded, expired, overflow Held-event replay state; omitted for a delivery that was never held. Only a delivery without one or with replay can be retried
status string 是 Delivery processing state, not Agent execution result

WebhookItem

字段 类型 必填 说明
binding EventBindingItem 是
credential_version integer (int64) 是
event_filter string 是

WorkReferenceItem

字段 类型 必填 说明
description string Current Project description
id string (uuid) 是 Stable work object UUID
is_default boolean Whether a Project is the organization default
kind string: project, issue 是 Referenced work object kind
label string 是 Current Project name or Issue title
project_id string (uuid) Parent Project UUID for an Issue
project_name string Current parent Project name for an Issue
resource_uri string 是 Canonical Project or Issue URI for message bodies
status string Current Project or Issue status

WsTicketData

字段 类型 必填 说明
expires_at string (date-time) 是 Ticket expiry (30 seconds from issuance)
ticket string 是 One-time WebSocket ticket. Use as query parameter: ws://host/ws?ticket=