This document

Responses

• 200

  This document

  application/yaml
• 401

  No credentials, or credentials that name nobody: none were sent, or the token is not a valid one. Nobody was resolved, so there is no caller to be forbidden.

  application/json
• 403

  You are signed in and may not do this. Three different things answer 403, and the body does not say which:

  • your role lacks the permission — reading needs the one to view bots, every write the one to edit them;
  • the brand is disabled or locked, on any operation;
  • the brand's subscription has expired, on a write. Reading still works.
  application/json
• 429

  Too many requests. Every call counts, reads included — the limit is on how fast you call, not on how much you change. It is 40 a second, counted per member rather than per account, so two people generating at once each get their own.

  application/json