ParrotDocs
Getting started

Accounts & signing in

Parrot has no guest mode. Every screen in the app requires a signed-in account, and every API call carries that account's token.

How a session works

  1. You open any app URL. Without a session the browser is sent to the sign-in page, remembering where you were headed.
  2. You sign in with your workspace email and password. The API returns a signed token valid for 7 days.
  3. The app verifies the token before rendering, then takes you to the page you originally asked for.
  4. If the token expires or is rejected, the session is cleared and you return to sign-in with a note explaining why.

Signing out clears the session everywhere it is held. There is no "remember this device" beyond the 7-day token.

Getting a workspace

Workspaces are opened with you rather than by self sign-up, so the AI knows your products and prices from the first message. Choose a plan and leave your details on the Contact us page of the website, and we get in touch to set yours up. You receive the owner account; the owner then adds the team.

Passwords

  • Change your own from your profile menu (top right) → Change password. You enter the current password first. Every other device signed in to your account is signed out; the one you are using stays signed in.
  • Forgotten password? Ask your workspace owner. In Settings → Team & Staff, the key icon beside a person sets a new password for them. A strong one is generated, shown once to hand over, and the person is signed out everywhere until they use it.
  • The owner can reset anyone except the owner; an admin can reset managers, agents and viewers, but not another admin.
  • Someone who belongs to more than one business changes their password themselves — one business cannot reset an account another business also uses.
  • A reset is recorded in CX Logs (who reset whose, and when — never the password).

Your role decides what you see

The role you hold in the active workspace drives both halves of access control:

  • The sidebar hides modules your role cannot view.
  • The API rejects calls your role cannot make, so a hidden link is never the only protection.
RoleTypically sees
OwnerEverything, including billing and workspace ownership
AdminEverything except workspace ownership
ManagerQueues, SLA, reports, tickets and the inbox
AgentInbox and tickets
ViewerRead-only access to what it is granted

Owners always have full access. Everything else is configured under Settings → Roles & Permissions.

Multiple workspaces

If your account belongs to more than one workspace, the switcher in the top bar lists them. Switching changes the active workspace for every subsequent request; your session stays the same.

Creating a workspace

Create one on the sign-in page registers an account and a workspace together and makes you its Owner. You can invite your team immediately under Settings → Team & Staff.

Getting an account

Accounts are created by an Owner or Admin under Settings → Team & Staff, who set your role at the same time. If you cannot sign in, ask them to confirm your account exists and which workspace it belongs to.