Team, plans and limits
A workspace has owners and members. This page covers invites and roles, then the delivery behavior and plan limits that apply to every hook.
Docs pagesTeam, plans and limits
On this pageTeam and invites
Team and invites
A workspace has owners and members. Owners invite people by email from the Settings page, and pick the role the invitee gets.
- An invite link works once and expires after 7 days. Revoking a pending invite stops its link at once.
- The invitee opens /invite/<token>, signed in with the invited address. That address must be verified. Accepting with any other account is refused.
- If no invite email can be sent, the owner sees the link once, on the Settings page, and passes it on.
- Owners invite, revoke invites, change roles, remove members, change alert settings and delete secrets. Members can read alert settings and set secrets.
- Anyone can leave a workspace, except the last owner. A workspace always keeps at least one owner, so promote another owner before the last one leaves, is removed or is demoted.
Behavior and limits
- The sender gets 200 as soon as the event is stored. Deliveries are queued and sent in the background, so a slow destination never makes the sender time out.
- Network errors, timeouts, 5xx, 408, 425 and 429 are retried on a schedule from 30 seconds to 24 hours (or the retry policy in the YAML), honouring Retry-After. Other 4xx and redirects fail at once.
- When the schedule is used up the delivery is marked failed and the event failed or partial. Retry the delivery or replay the event once the cause is fixed.
- Requests that repeat a provider delivery id (webhook-id, x-github-delivery, x-shopify-webhook-id, ...) within 24 hours are accepted once.
- Destinations must be public HTTPS URLs; private, loopback and metadata addresses are refused.
- Events keep their payload, deliveries and attempt logs unless logging.retainPayload is false. They are kept for 7 days on Free and 30 days on Pro, or less if a hook sets logging.retainDays.
- Each workspace can create 5 hooks on Free and 25 on Pro. Creating one past the limit is refused; updating an existing hook always works.
- Events are metered monthly: 10,000 on Free and 100,000 on Pro. Past the allowance, events keep flowing and the usage page shows the overage.
- Hosted agent generations are metered monthly: 50 on Free and 1,000 on Pro. Up to 10 generations a minute per workspace. Instructions are limited to 4,000 characters and the sample payload to 64 KB.
- Upgrading and cancelling are on the Usage page. Stripe runs checkout and the billing portal, which holds invoices and the payment method.
- Incoming bodies are limited to 1 MB.
- There is no ordering guarantee between events.