跳到文档正文
浏览和搜索
本页内容

confirm_action

对方读出邮件中的 6 位验证码后,执行暂存的变更。再次调用会返回相同结果,不会重复执行。confirm 级:调用只会暂存并返回这项变更。request_confirmation_code 向对方邮箱发送验证码,对方读出验证码后,confirm_action 才会执行变更。同名 MCP 工具需要 tweetstream:billing 权限范围。

POST/api/agent/actions/confirm_action

授权

  • Authorizationstringheader必填使用 TweetStream API 密钥进行 Bearer 认证:Bearer <key>。

请求体

  • challengeIdstring可选a string at most 128 character(s) long
  • codestring可选a string matching the pattern ^\d{6}$
  • pendingActionIdstring必填a string at most 64 character(s) long

响应字段

  • actionenum<string>必填
  • outcomeobject必填
    • chargedCentsnumber可选
    • effectiveAtstring必填a string to be decoded into a Date
    • kindenum<string>必填
    • refundenum<string>可选
  • pendingActionIdstring必填
  • statusenum<string>必填

响应

  • 200成功
  • 400输入无效,或验证码错误(INVALID_CODE)
  • 401API key 缺失或无效
  • 403请求带有外部 Origin
  • 404此 API key 下没有该 pendingActionId 对应的暂存变更(CONFIRMATION_NOT_FOUND)
  • 409暂存的变更已过期(CONFIRMATION_EXPIRED)
  • 429已达到速率限制(RATE_LIMITED),请在 retryAfterSeconds 秒后重试
  • 503暂时不可用,请稍后重试