> ## Documentation Index > Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Core objects > Workspace, project and agent: the three containers everything else in Voiceflow sits inside, and the words most API calls are keyed by. A **workspace** holds **projects**. One project owns exactly one **agent**. Everything else is a part of an agent. The three containers everything else sits inside, the words most API calls are keyed by, and the people and plans around them — one section per term. ## Containers ### Workspace The container that groups projects and the people who work on them. Billing and membership live here. See [Collaboration](/docs/documentation/account-management/collaboration). **Also asked as:** - the top-level account my team shares - where members, billing and projects are managed together - invite my team to work on the same agents - where billing for the whole team lives **Related:** [Project](#project) · [Role](#role) · [Plan](#plan) **Documented in:** [Workspaces › Organizing your workspace](/docs/documentation/account-management/collaboration#organizing-your-workspace) · [Workspaces › Inviting team members](/docs/documentation/account-management/collaboration#inviting-team-members) · [Manage (API)](/docs/api-reference/sections/manage) ### Project The container that owns exactly one agent. Most API and CLI calls take a `projectID`. **Also asked as:** - the thing I create for each assistant - the ID most endpoints need - create a new agent from scratch - organize agents into folders **Related:** [Agent](#agent) · [Environment](/docs/resources/glossary/deploy#environment) **Documented in:** [Building an agent › Key concepts](/docs/documentation/build/overview#key-concepts) ### Agent The thing that holds a conversation. The docs use *agent* throughout; never "chatbot". **Also asked as:** - the bot itself - the assistant that talks to customers - the voice or chat assistant I'm building - what talks to my customers **Related:** [Project](#project) · [Global prompt](/docs/resources/glossary/build#global-prompt) · [Conversation](#conversation) **Documented in:** [Building an agent › Agent](/docs/documentation/build/overview#agent) · [Build AI agents with Voiceflow › What is Voiceflow?](/docs/documentation/introduction#what-is-voiceflow) ### Conversation One exchange between a person and the agent, addressed by a `userID` you choose. The same value always addresses the same conversation. **Also asked as:** - a session with one customer - the chat or call as a whole - one full exchange with a customer - how a session is identified **Related:** [User ID](#user-id) · [Transcript](/docs/resources/glossary/measure#transcript) · [Session timeout](/docs/resources/glossary/build#session-timeout) **Documented in:** [Variables › Built-in variables](/docs/documentation/build/data/variables#built-in-variables) ### User ID The identifier that addresses a conversation and, as the built-in `user_id` variable, tells the agent who it is talking to. The widget can pass a custom one; on phone and SMS channels the caller's or sender's number fills it automatically. **Also asked as:** - recognise a returning customer - tie a chat to a logged-in account - the caller's number as their identity **Related:** [Conversation](#conversation) · [Built-in variables](/docs/resources/glossary/knowledge-and-data#built-in-variables) · [Chat widget API](/docs/resources/glossary/deploy#chat-widget-api) **Documented in:** [Chat widget API › Passing a custom user ID](/docs/documentation/deploy/widget/web-chat-api#passing-a-custom-user-id) · [Inbound calling › Caller identification](/docs/documentation/deploy/phone/inbound-calling#caller-identification) · [Inbound SMS › Sender identification](/docs/documentation/deploy/sms/inbound#sender-identification) ## People and plans ### Role One of five workspace roles a member is assigned: Owner has full control including billing, settings and membership; the others narrow what a member can edit or view. Viewers and billing users can be given edit access to specific projects without a workspace-wide upgrade. **Also asked as:** - give a colleague view-only access - who can change billing - let one person edit just one project **Related:** [Workspace](#workspace) · [Project-level permissions](#project-level-permissions) **Documented in:** [Workspaces › Roles](/docs/documentation/account-management/collaboration#roles) ### Project-level permissions Edit access granted to a viewer or billing user on specific projects, while their workspace role stays the same. **Also asked as:** - editor rights on one project only - per-project access instead of a workspace seat - give a viewer edit access to a single project - restrict a contractor to one agent **Related:** [Role](#role) **Documented in:** [Workspaces › Project-level permissions](/docs/documentation/account-management/collaboration#project-level-permissions) ### Plan What controls which features a workspace has and its monthly credit allotment: Free, and the paid tiers, with add-ons for extra editor seats and phone numbers. Enterprise customers are billed per contract. **Also asked as:** - what do I get on the free tier - upgrade or downgrade my subscription - how pricing tiers differ **Related:** [Credits](/docs/resources/glossary/measure#credits) · [Add-on](#add-on) · [Workspace](#workspace) **Documented in:** [Billing overview › Plans](/docs/documentation/account-management/billing#plans) · [Managing your subscription › Changing your plan](/docs/documentation/account-management/billing/managing-your-subscription#changing-your-plan) ### Add-on Extra capacity billed monthly alongside the plan: editor seats and Voiceflow phone numbers, adjusted from the Add-ons tab in Plans and Billing. **Also asked as:** - buy another seat for a teammate - add a phone number to my subscription - more editor seats for the team - buy extra phone numbers **Related:** [Plan](#plan) · [Phone number](/docs/resources/glossary/deploy#phone-number) **Documented in:** [Billing overview › Add-ons](/docs/documentation/account-management/billing#add-ons) · [Managing your subscription › Managing add-ons](/docs/documentation/account-management/billing/managing-your-subscription#managing-add-ons) ### Auto top-up Automatic purchase of additional credits when the balance hits zero, so agents never stop mid-month. **Also asked as:** - stop the bot from going down when credits run out - refill credits automatically - what happens when credits run out mid-month - keep the bot from stopping when the balance hits zero **Related:** [Credits](/docs/resources/glossary/measure#credits) · [Plan](#plan) **Documented in:** [Managing your subscription › Enabling auto top-ups](/docs/documentation/account-management/billing/managing-your-subscription#enabling-auto-top-ups) · [Managing your subscription › Changing your credit bundle](/docs/documentation/account-management/billing/managing-your-subscription#changing-your-credit-bundle) ### Invoices and billing details The Billing tab in Plans and Billing: the billing email that receives invoices, receipts, renewal reminders and failed-payment alerts; the payment method; past invoices as PDFs; and cancelling the subscription. Enterprise customers are billed per contract through an account manager. **Also asked as:** - download last month's invoice - change the card on file - end the paid plan - who receives the billing emails **Related:** [Plan](#plan) · [Credits](/docs/resources/glossary/measure#credits) **Documented in:** [Managing your subscription › Updating billing details](/docs/documentation/account-management/billing/managing-your-subscription#updating-billing-details) · [Managing your subscription › Downloading invoices](/docs/documentation/account-management/billing/managing-your-subscription#downloading-invoices) · [Managing your subscription › Canceling your subscription](/docs/documentation/account-management/billing/managing-your-subscription#canceling-your-subscription) · [Billing overview › Enterprise billing](/docs/documentation/account-management/billing#enterprise-billing)