# Terminus Hub

> Documentation for Terminus Hub: build governance models, manage data taxonomies, and publish records.

- [Terminus Hub: structured data governance for teams](https://docs.terminus.app/introduction.md): Terminus Hub lets teams define a governance model for their campaign data, collect it through a governed workflow, and turn approved records into short URLs, QR codes, and click analytics.
- [Quickstart](https://docs.terminus.app/quickstart.md): Go from a new Terminus Hub account to your first short URL: start from a template, publish a revision, connect it to a workspace, and build your first URL.
- [Your dashboard](https://docs.terminus.app/guides/dashboard.md): What the Terminus Hub home screen shows, how the six-step setup checklist works, why sections change as your account matures, and what admins see that members don't.
- [Key concepts](https://docs.terminus.app/key-concepts.md): A short glossary of the core nouns in Terminus Hub: governance models, taxonomies, fields, picklists, submissions, records, short URLs, QR codes, and workspaces.
- [Sign up and sign in](https://docs.terminus.app/authentication.md): Create a Terminus Hub account, sign in with a password or single sign-on, enter a two-factor code, accept an invitation, and recover when you are locked out.
- [Profile settings](https://docs.terminus.app/account/profile.md): Update your display name, the email you sign in with, and your password, and turn two-factor authentication on or off from your own profile settings page.
- [Campaign URL Builder tutorial](https://docs.terminus.app/tutorial/index.md): Build a complete marketing governance model end to end in seven short parts, turning campaign details into UTM-tagged, shortened, QR-coded links.
- [Part 2: Create your governance model](https://docs.terminus.app/tutorial/02-governance-model.md): Create the Marketing governance model and the 2026 Campaigns workspace, the empty shells everything else slots into.
- [Part 3: Fields basics](https://docs.terminus.app/tutorial/03-fields-basics.md): Add three user-input fields (Campaign Name, Launch Date, Destination URL) and learn field types, required and unique, defaults, and text transforms.
- [Part 4: Static picklists](https://docs.terminus.app/tutorial/04-static-picklists.md): Build the Goals static picklist and a Goal Dropdown field, and learn how an option's code and its label differ and why the code is what matters.
- [Part 5: Hierarchical picklists](https://docs.terminus.app/tutorial/05-hierarchical-picklists.md): Build a two-level Countries and Regions picklist and two dropdown fields, where picking a country narrows the region list automatically.
- [Part 6: The UTM cascade](https://docs.terminus.app/tutorial/06-utm-cascade.md): Build the UTM Mediums and Sources hierarchy, learn how option lists change over time, and meet per-taxonomy option filtering.
- [Part 7: Computed fields](https://docs.terminus.app/tutorial/07-computed-fields.md): Wire the four-level computed chain (UTM Campaign, Tagged URL, Short URL, QR Code) that turns user input into a QR code automatically.
- [Part 8: Your first submission](https://docs.terminus.app/tutorial/08-first-submission.md): Assemble three taxonomies with per-taxonomy option filters, then run a campaign from a draft through to approved records with live short URLs.
- [The Terminus Hub data model](https://docs.terminus.app/concepts/data-model.md): A one-page map of how governance models, taxonomies, fields, picklists, submissions, and records fit together.
- [Picklist structures](https://docs.terminus.app/concepts/picklist-structures.md): A field guide to the four picklist structures (simple, linear cascade, branching cascade, conditional) and the two option sources (static and automatic).
- [Create and manage governance models](https://docs.terminus.app/reference/governance-models.md): Create a governance model from scratch, from a template, or from a JSON file, then rename, export, import, and delete it.
- [Build and manage taxonomies](https://docs.terminus.app/reference/taxonomies.md): Create a taxonomy, add and order its fields, set per-taxonomy field settings, connect it to workspaces, and clone or delete it.
- [Publish a Revision and Manage Governance Model Versions](https://docs.terminus.app/guides/publish-revision.md): Review your draft changes, publish them as a numbered revision so they reach submitters, discard a draft you don't want, and read the revision history.
- [Start From a Template and Experiment in a Playground](https://docs.terminus.app/guides/templates-playground.md): Browse ready-made governance-model templates and turn one into a new model in one click, or open a throwaway Playground from a shared link to explore and edit a copy of a model without creating any real data.
- [Cascading dropdowns](https://docs.terminus.app/recipes/cascading-dropdowns.md): Build a child dropdown that narrows to the parent selection, either from a hand-authored hierarchical picklist or live from another taxonomy's records.
- [Build a UTM-tagged campaign URL](https://docs.terminus.app/recipes/tagged-url-utm.md): Use a Tagged URL field to append UTM parameters to a base URL from other fields, set sources per taxonomy when they differ, then optionally shorten it.
- [Pick a Short URL slug mode](https://docs.terminus.app/recipes/short-url-slug-modes.md): Choose how a Short URL field generates its slug so the right person controls it at the right time.
- [Letting submitters enter new values](https://docs.terminus.app/recipes/suggest-past-values.md): Use a Text field with Suggest from past entries so submitters can type new values while the form nudges them toward spellings the account has already approved.
- [Filter dropdown options per taxonomy](https://docs.terminus.app/recipes/filter-options-per-taxonomy.md): Reuse one picklist across taxonomies while showing only the options that fit each one, using option filters.
- [Automated picklist](https://docs.terminus.app/recipes/automated-picklist.md): Build a dropdown whose options come live from another taxonomy's approved records and grow on their own as records are approved.
- [Fill modes](https://docs.terminus.app/concepts/form-vs-grid-mode.md): When you build a URL or record, you fill it in through one of three modes: Quick, Form, or Grid. What each is for and when to use which.
- [Bulk entry via grid mode](https://docs.terminus.app/recipes/bulk-entry-grid-mode.md): Enter many campaign rows fast in the builder's grid mode by pasting from a spreadsheet, importing a CSV, or generating combinations, then save as a draft and create them.
- [Work with records](https://docs.terminus.app/guides/records.md): Find existing links and records, save views, export to CSV, build a new URL, clone one you already have, and change or delete records through a submission.
- [Review and Approve Submissions](https://docs.terminus.app/guides/review-and-approve-submissions.md): Move submissions through draft, awaiting review, and approved; comment, get notified, and turn entries into records.
- [The submission pipeline](https://docs.terminus.app/concepts/submission-pipeline.md): What happens after you click Build URL or New record: filling in rows, computed fields, review, approval, and your short URLs going live.
- [Connect Claude, ChatGPT, and Other AI Apps](https://docs.terminus.app/guides/connect-ai-apps.md): Connect an AI app to Terminus Hub over MCP so it can look up your taxonomies and records, build links in a draft submission, and submit them as you.
- [Share and Embed Your Governance Model with External Viewers](https://docs.terminus.app/guides/share-embed.md): Create a public, read-only link to a governance model that anyone can open without an account, and embed that same interactive view in another site with an iframe.
- [Analyze Link Clicks, QR Scans, and Visitor Data](https://docs.terminus.app/guides/analytics.md): Track clicks and QR scans on your short URLs: headline KPIs, UTM, geo, and device breakdowns, pivot tables, and per-link stats.
- [Account administration](https://docs.terminus.app/account/overview.md): Find every account-level setting, from members and billing to domains and API keys, in one place.
- [Managing Team Members in Terminus Hub](https://docs.terminus.app/account/team-members.md): Invite people, assign account and workspace roles, suspend or remove members, and understand how seats relate to your plan.
- [Security](https://docs.terminus.app/account/security.md): Require two-factor authentication for everyone in your account, see what members experience when it is on, and know who is exempt.
- [Single sign-on (SAML)](https://docs.terminus.app/account/sso.md): Connect your SAML identity provider so your team signs in to Terminus Hub through it, then optionally enforce SSO for members.
- [Billing and plans](https://docs.terminus.app/account/billing.md): How your Business trial works, how to subscribe or change plans, how seats are billed, and what happens when an account is locked.
- [Managing Workspaces in Terminus Hub](https://docs.terminus.app/account/workspaces.md): Create workspaces, connect taxonomies, assign members, clone, and delete them from the account.
- [Custom domains](https://docs.terminus.app/account/custom-domains.md): Serve your short links from your own domain with automatic HTTPS, then keep them healthy with ongoing checks and email alerts.
- [QR styles](https://docs.terminus.app/account/qr-styles.md): Design reusable QR code looks with your colors, logo, and a scan-me frame, and set the default style your account's QR codes render in.
- [Outbound webhook connectors](https://docs.terminus.app/account/outbound-connectors.md): Push approved records to your own HTTPS endpoint automatically, with signed, idempotent deliveries and no manual exporting.
- [API Keys for Terminus Hub](https://docs.terminus.app/account/api-keys.md): Create, copy, and revoke API keys for the Terminus Hub API, and understand how keys are scoped.
- [Fields](https://docs.terminus.app/reference/fields/index.md): Fields are the columns of a governance model. Each has one immutable type that decides whether you enter its value or the system computes it.
- [Computed fields](https://docs.terminus.app/recipes/other-computed-fields.md): An overview of the computed field types: what each one generates, how to choose between them, and the rules they all share.
- [Text field](https://docs.terminus.app/reference/fields/text.md): An entered field that stores free text, with optional length limits, character rules, and case and space transforms.
- [URL field](https://docs.terminus.app/reference/fields/url.md): An entered field that stores a web address and serves as the base for Tagged URL and Short URL fields.
- [Date field](https://docs.terminus.app/reference/fields/date.md): An entered field that stores a calendar date and renders it in a format you configure.
- [Dropdown field](https://docs.terminus.app/reference/fields/dropdown.md): A user-entered field whose value is chosen from a picklist, with single or multi-select, conditional picklists, and cascading selections.
- [Auto Number field](https://docs.terminus.app/reference/fields/auto-number.md): A computed field that stamps each record with the next number in a sequence, optionally zero-padded to a fixed width.
- [Random field](https://docs.terminus.app/reference/fields/random.md): A computed field that generates a random string of a fixed length from the character sets you enable.
- [Concatenation field](https://docs.terminus.app/reference/fields/concatenation.md): A computed field that joins the values of other fields into one string with a separator, such as a UTM campaign name.
- [Auto-fill field](https://docs.terminus.app/reference/fields/autofill.md): A computed field that derives its value from other fields, either copying one field with transforms or evaluating an expression with filters and conditions.
- [Tagged URL field](https://docs.terminus.app/reference/fields/tagged-url.md): A computed field that builds a destination URL with UTM query parameters drawn from other fields on the same record.
- [Short URL field](https://docs.terminus.app/reference/fields/short-url.md): A field that mints a short branded link for each record, redirects clicks to a destination URL held by another field, and records every click for analytics.
- [QR Code field](https://docs.terminus.app/reference/fields/qr-code.md): A computed field that produces a downloadable QR-code image encoding another field's value, usually a record's short URL.
- [Constant field](https://docs.terminus.app/reference/fields/constant.md): A computed field that writes the same fixed value to every record.
- [Terminus ID field](https://docs.terminus.app/reference/fields/terminus-id.md): A computed field that surfaces the record's system-generated unique identifier, in the format trm0 followed by alphanumeric characters.
- [Picklists](https://docs.terminus.app/reference/picklists/index.md): A picklist is the reusable list of allowed values behind a dropdown field. Terminus Hub has static, hierarchical, and automated picklists.
- [Static picklist](https://docs.terminus.app/reference/picklists/static.md): A hand-authored list of options (code plus label) stored on the governance model and referenced by one or more dropdown fields.
- [Hierarchical picklist](https://docs.terminus.app/reference/picklists/hierarchical.md): A static picklist with more than one level, so a child dropdown only offers the options that belong to the parent the submitter picked.
- [Automated picklist](https://docs.terminus.app/reference/picklists/automated.md): A picklist whose options come live from the approved records of another taxonomy, with one or more levels that can cascade.
- [Submissions](https://docs.terminus.app/reference/submissions.md): A submission is one or more rows of data entered against a taxonomy that move through a fixed lifecycle until they are approved into records or discarded.
- [Records](https://docs.terminus.app/reference/records.md): Reference for records: the read-only approved rows of a taxonomy, their Terminus ID and statuses, grid limits, saved views, and the CSV export format.
- [Field-reference overrides](https://docs.terminus.app/reference/field-reference-overrides.md): Adjust a field for one taxonomy (or one workspace) without changing the field itself: make it required, filter which dropdown options appear, or set where Tagged URL parameters get their values.
- [Workspaces](https://docs.terminus.app/reference/workspaces.md): Quick reference for workspaces: per-workspace roles, plan limits, connection settings, option filter modes, and what cloning copies.
- [Plans and limits](https://docs.terminus.app/reference/plans-and-limits.md): Which features need a higher plan, which limits depend on your plan, when each is checked, and what happens when you downgrade.
- [Terminus Hub Public API v1: Overview](https://docs.terminus.app/api-reference/overview.md): The Terminus Hub REST API: a read-only, versioned JSON interface for workspaces, governance models, submissions, and records.
- [Terminus Hub API Authentication](https://docs.terminus.app/api-reference/authentication.md): Learn how to authenticate with the Terminus Hub Public API using Bearer API keys and handle common authentication errors in your integration.
- [API Pagination, Errors, and Rate Limits](https://docs.terminus.app/api-reference/pagination-errors.md): How Terminus Hub API list endpoints paginate, how every error response is structured, and how rate limits and their headers work.
- [List governance models](https://docs.terminus.app/api-reference/endpoints/governance-models/list-governance-models.md): Return a page of the governance models in your account, with each model's ID, name, and description.
- [Show a governance model](https://docs.terminus.app/api-reference/endpoints/governance-models/show-a-governance-model.md): Return one governance model by ID, with its name and description.
- [List all workspaces](https://docs.terminus.app/api-reference/endpoints/workspaces/list-all-workspaces.md): Return a page of the workspaces in your account, with each workspace's ID, name, and description.
- [Show a workspace](https://docs.terminus.app/api-reference/endpoints/workspaces/show-a-workspace.md): Return one workspace by ID, with its name and description.
- [List submissions](https://docs.terminus.app/api-reference/endpoints/submissions/list-submissions.md): Return a page of submissions in a workspace, with each submission's name, taxonomy, status, and rows.
- [List all records](https://docs.terminus.app/api-reference/endpoints/records/list-all-records.md): Return a page of records in your account, oldest first, optionally narrowed to one workspace or taxonomy.
- [Show a record](https://docs.terminus.app/api-reference/endpoints/records/show-a-record.md): Return one record by ID, including its status, Terminus ID, revision, and every field value keyed by field ID.
- [List governance models](https://docs.terminus.app/api-reference/governance-models/list-governance-models.md)
- [Show a governance model](https://docs.terminus.app/api-reference/governance-models/show-a-governance-model.md)
- [List all records](https://docs.terminus.app/api-reference/records/list-all-records.md)
- [Show a record](https://docs.terminus.app/api-reference/records/show-a-record.md)
- [List submissions](https://docs.terminus.app/api-reference/submissions/list-submissions.md)
- [List all workspaces](https://docs.terminus.app/api-reference/workspaces/list-all-workspaces.md)
- [Show a workspace](https://docs.terminus.app/api-reference/workspaces/show-a-workspace.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.