# Terminus Hub

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

## Docs

- [API Keys for Terminus Hub](https://docs.terminus.app/account/api-keys.md): What an API key is, how it authenticates requests to the Terminus Hub API, and how keys are scoped and provisioned today.
- [Billing and plans](https://docs.terminus.app/account/billing.md): Compare plan tiers, start a free trial, upgrade or change your plan, manage seats and payment, and see what each plan unlocks.
- [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.
- [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.
- [Profile settings](https://docs.terminus.app/account/profile.md): Update your display name, the email you sign in with, and your password from your own profile settings page.
- [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.
- [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.
- [Terminus Hub API Authentication & API Keys](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.
- [List governance models](https://docs.terminus.app/api-reference/endpoints/governance-models/list-governance-models.md)
- [Show a governance model](https://docs.terminus.app/api-reference/endpoints/governance-models/show-a-governance-model.md)
- [List all records](https://docs.terminus.app/api-reference/endpoints/records/list-all-records.md)
- [Show a record](https://docs.terminus.app/api-reference/endpoints/records/show-a-record.md)
- [Create a submission](https://docs.terminus.app/api-reference/endpoints/submissions/create-a-submission.md)
- [List submissions](https://docs.terminus.app/api-reference/endpoints/submissions/list-submissions.md)
- [List all workspaces](https://docs.terminus.app/api-reference/endpoints/workspaces/list-all-workspaces.md)
- [Show a workspace](https://docs.terminus.app/api-reference/endpoints/workspaces/show-a-workspace.md)
- [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)
- [Terminus Hub Public API v1: Overview](https://docs.terminus.app/api-reference/overview.md): Explore the Terminus Hub REST API: a versioned, JSON-based interface for managing Workspaces, Governance Models, Submissions, and Records.
- [API Pagination, Error Handling & Response Shapes](https://docs.terminus.app/api-reference/pagination-errors.md): Understand how Terminus Hub API list endpoints paginate results and how every error response is structured, with types, codes, and example payloads.
- [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)
- [Create a submission](https://docs.terminus.app/api-reference/submissions/create-a-submission.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)
- [Authentication](https://docs.terminus.app/authentication.md): How you sign in to Terminus Hub with email and password (or SSO), and how to authenticate API requests with an account API key.
- [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.
- [Fill modes](https://docs.terminus.app/concepts/form-vs-grid-mode.md): The builder's three fill modes (Quick, Form, and Grid), what each is for, and when to use which.
- [The submission pipeline](https://docs.terminus.app/concepts/submission-pipeline.md): The path a submission travels from data entry to a live record: filling rows, computed fields, review, approval, and short URLs going live.
- [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.
- [Publish a Revision and Manage Governance Model Versions](https://docs.terminus.app/guides/publish-revision.md): Freeze your governance model into a numbered revision so structure changes reach submitters, and read the revision history.
- [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.
- [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.
- [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 to explore and edit a copy of a model without creating any real data.
- [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.
- [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.
- [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, make a submission, and approve it into a record.
- [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.
- [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, then save as a draft and submit.
- [Cascading dropdowns](https://docs.terminus.app/recipes/cascading-dropdowns.md): Build a child dropdown that narrows to the parent selection, either from hand-authored lists or live from another taxonomy's records.
- [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 include or exclude filters.
- [Other computed fields](https://docs.terminus.app/recipes/other-computed-fields.md): A tour of the standalone computed fields (concatenation, auto number, random, constant, Terminus ID): what each one generates and when to reach for 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.
- [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, then optionally shorten it.
- [Letting submitters add options](https://docs.terminus.app/recipes/user-addable-options.md): Let submitters propose new dropdown values inline, promoted to real picklist options only when the submission is approved.
- [Field-reference overrides](https://docs.terminus.app/reference/field-reference-overrides.md): Tighten a field's behavior for one taxonomy (or one workspace): make it required or hidden, or filter which dropdown options appear, without changing the field itself.
- [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.
- [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.
- [Constant field](https://docs.terminus.app/reference/fields/constant.md): A computed field that writes the same fixed value to every record.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Governance models](https://docs.terminus.app/reference/governance-models.md): The top-level container for the fields, picklists, and taxonomies that define how your team's campaign metadata is structured.
- [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.
- [Hierarchical picklist](https://docs.terminus.app/reference/picklists/hierarchical.md): A static picklist linked to a parent picklist so a child dropdown only offers the options that match the parent selection.
- [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.
- [Records](https://docs.terminus.app/reference/records.md): The read-only, approved campaign rows for a taxonomy, with grouping, filtering, browser-saved views, and full-dataset CSV export.
- [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.
- [Taxonomies](https://docs.terminus.app/reference/taxonomies.md): A named, ordered grouping of a governance model's fields that becomes a submission form, connects to workspaces, and sets whether submissions need review.
- [Workspaces](https://docs.terminus.app/reference/workspaces.md): An account sub-division that connects taxonomies and scopes the submissions, records, and members that work within it.
- [Set up your account](https://docs.terminus.app/setup-checklist.md): Follow the dashboard setup checklist to get your first governance model live and invite your team.
- [Part 1: What you'll build](https://docs.terminus.app/tutorial/01-overview.md): The end-state architecture of a real campaign URL builder and the seven concepts you'll wire together across the tutorial.
- [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: User-addable picklists](https://docs.terminus.app/tutorial/06-user-addable-picklists.md): Build the UTM Mediums and Sources hierarchy, turn on Allow new values so submitters can propose options, 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.
- [Campaign URL Builder tutorial](https://docs.terminus.app/tutorial/index.md): Build a complete marketing governance model end to end across eight short parts, turning campaign details into UTM-tagged, shortened, QR-coded links.

## OpenAPI Specs

- [openapi](https://docs.terminus.app/api-reference/openapi.yaml)