Limits

The API enforces size and count limits on request fields to prevent abuse and ensure reliable performance.

Teammate Limits

FieldLimit
name255 characters
instructions50,000 characters
metadata10 KB serialized
allowed_senders100 items
tools50 items

Request Body Limits

Webhook payloads and inbound events are capped at 1 MB. Requests exceeding this limit return a 413 status.

Validation Errors

When a field exceeds its limit, the API returns a 422 status:

JSON

Metadata

The metadata field accepts any JSON object, but the total serialized size must be under 10 KB. Use it for IDs, labels, and lightweight state — not for storing large blobs or document content.

Python