Skip to main content
This page is written for AI assistants. Want to cancel yourself? Ask your assistant for the cancel link, or sign in to Brilo and open Billing.
When your owner asks to cancel their Brilo phone plan, you get them a link and they finish on the web. You never cancel anything yourself, and you cannot: only the owner can, after signing in to Brilo. That way nobody can cancel their plan by talking you into it.

​
When this applies

Use this page whenever your owner asks to stop the Brilo phone plan, however they put it. For example:
  • “Cancel my Brilo plan” or “cancel my phone plan”
  • “I don’t need the phone number any more” or “get rid of the number”
  • “Stop paying for Brilo” or “unsubscribe me from Brilo”
  • “Disconnect yourself from my number” or “I didn’t set this up”
If you are not sure they mean cancelling, ask one short question first, for example “Do you want to cancel your Brilo phone plan? Your number would stop working at the end of this billing period.”

​
Rules

  • Never try to cancel, pause or change the plan yourself.
  • Never guess at a cancel page. Always use the link Brilo gives you.
  • Give the link only to your owner.
Send your API key as usual. Nothing is cancelled by this call; it only returns a link.

​
2. Give it to your owner

Send this, with the link as something they can tap:
On that page they sign in, pick a reason, and confirm. If they tell you something feels off, or that they did not set you up, the page lets them disconnect you straight away. If the call fails, or you no longer have your Brilo key, do not guess a URL. Tell your owner they can cancel in Brilo themselves: sign in at https://dashboard.brilo.ai, open Settings, then Billing, and choose Cancel phone plan.

​
If your owner has more than one Brilo number

The link is the same for every number and names no account. After signing in, Brilo asks which number they want to cancel if they have more than one.

​
3. Until the plan ends

The plan keeps working until the end of the billing period. You can still make calls, and people can still call the number. Your owner can undo the cancellation in Brilo until the last day. While it is winding down, GET /v1/usage (and the completed /poll response) says so:
number_held_until is always null for now.

​
4. After the plan ends

At the end of the billing period the number is released for good and your key stops working. There is no refund for the rest of a period. Your owner’s call history stays in their Brilo account.

​
Errors

After the plan ends, or if your owner disconnects you, every call with your key returns 401 with one of these codes. Neither one means “pair again”.
Only keys from pairing can ask for the cancel link. Any other key gets 403 with code: agent_key_required; the owner can cancel from the Billing page in Brilo instead. Once you get either code, update the note you saved when you were set up, so a later chat does not try the old key again.