Skip to content

docs(api): publish composed message ceiling#485

Merged
jiashuoz merged 3 commits into
mainfrom
codex/composed-cap-contract
Jul 15, 2026
Merged

docs(api): publish composed message ceiling#485
jiashuoz merged 3 commits into
mainfrom
codex/composed-cap-contract

Conversation

@jiashuoz

Copy link
Copy Markdown
Member

Summary

Publish the already-enforced composed outbound-message ceiling in the API contract.

  • exact limit: 10 MiB / 10,485,760 bytes
  • byte basis: subject + text + HTML + decoded attachment bytes
  • send/reply/forward: 413 payload_too_large with composed-size detail keys
  • approve-review: same ceiling after overrides merge with the held draft
  • regenerated TypeScript and Python SDK bases

Client surface checklist

  • Go contract descriptions + regression assertions
  • OpenAPI refreshed
  • Generated TypeScript/Python bases refreshed
  • Public API documentation updated
  • Runtime semantics unchanged

Operational risk

Low; contract/documentation-only behavior alignment. The approve path truthfully leaves structured details optional because its current runtime error mapper emits status/code/message only.

Test plan

  • go test ./internal/httpapi -count=1
  • make generate-check
  • TypeScript SDK build
  • Changed Python generated modules compile
  • git diff --check

@jiashuoz jiashuoz marked this pull request as ready for review July 15, 2026 06:03
@jiashuoz jiashuoz merged commit 7bdc3c6 into main Jul 15, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant