跳转到内容
tansr 资料站

应用更新:name / status(disabled = 末端全拒 fail-closed)/ ipAllowlist(CIDR 数组,逐条可解析,null = 清除)/ signRequired(即时生效于 /t1 认证链)

PATCH
/v1/apps/{id}

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
x-tansr-org
string

Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
string
>= 1 characters <= 128 characters
status
Any of:
string
Allowed value: active
ipAllowlist
Any of:
Array<string>
<= 32 items
signRequired

True = 未签名 /t1 请求恒 401 signature_invalid(T-A34)

boolean
quota
Any of:
object
dailyTokens
required
Any of:
integer
>= 1
endUserDailyTokens
required
Any of:
integer
>= 1
rpm
required
Any of:
integer
>= 1
endUserDailyImages
Any of:
integer
>= 1
endUserDailyVideoSeconds
Any of:
integer
>= 1
endUserDailyAsrSeconds
Any of:
integer
>= 1
endUserDailyTtsChars
Any of:
integer
>= 1
capabilities
Any of:
object
tools
required
object
read
required
boolean
write
required
boolean
edit
required
boolean
glob
required
boolean
grep
required
boolean
list
required
boolean
shell
required
boolean
process
required
boolean
webFetch
required
boolean
webSearch
required
boolean
http
required
boolean
todoWrite
required
boolean
askUser
required
boolean
agent
required
boolean
skills
required
boolean
mcp
required
boolean
customTools
required
boolean
platform
required
object
imageGen
required
boolean
videoGen
required
boolean
webSearch
required
boolean
speechToText
boolean
textToSpeech
boolean
platform
Any of:
string
Allowed value: desktop
purpose
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

已更新({app})

Media typeapplication/json
object
key
additional properties
any
Examplegenerated
{}

400

Section titled “400”

Validation_failed(CIDR 不可解析/超 32 条)

Media typeapplication/json
object
error
required
object
code
required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string
Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded
message
required
string
requestId
required
string
detail
object
Example
{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}

404

Section titled “404”

Not_found

Media typeapplication/json
object
error
required
object
code
required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string
Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded
message
required
string
requestId
required
string
detail
object
Example
{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}