Service list

The service list at /{workspace}/services is the landing page for a workspace. It shows every service in the selected workspace as a card, with search and filtering across the top and a Create Service action.

Layout

A header with the workspace title, a service count, search, and filters.
A responsive grid displays one card for each service.

The list displays every loaded service and does not paginate or sort the results. Search and filters update the displayed cards as you type.

Header

The header shows the heading Services and a subtitle of the form {n} services in {workspace}. On the right is the Create Service button (a + icon), which opens the new-service flow at /{workspace}/services/new.

When a workspace has no services, the header displays the title and workspace name. Search and filters are hidden, and the empty state displays the create action.

Search

A single search box (Search services…) filters the list as you type. It matches, case-insensitively, on:

Service name.
Service subdomain.
Service slug.

There is no special query syntax: it is a substring match on those three fields.

Filters

A Filters button opens a dialog with two filters:

Filter	Options
Status	All statuses, Active, Draft, Archived
Tag	All tags, plus every tag defined in the workspace

Select filter values, then click Apply Filters. To reset the values, click Clear. The Filters button displays the number of active filters. Applied filters also appear as removable chips under the header, such as Status: Active and Tag: billing. The Clear filters button resets every filter except the search text.

The list view supports Status and Tag filters.

Service card

Each card links to the service and summarizes its state.

Name: links to the schema editor (/services/{id}/editor).
Service status badge: Active, Draft, or Archived, as defined in the Service statuses section.
Hosting badge: Hosted (cloud) or Self-hosted (server), derived from the workspace subscription.
Deployed badge: shown when the service has an active Apso deployment.
Billing badge (hosted plans, deployed services): Included or +${n}/mo depending on whether the service is within the plan’s included allotment.
Repository: when a GitHub repo is connected, the owner/repo and branch are shown.
Tags: up to two tag chips, then +N more.
Metadata row: entity count (from the schema), owner name (or Not assigned), and a relative timestamp (Deployed 2h ago for deployed hosted services, otherwise Updated 2h ago).
Actions menu (⋮): Context-dependent links include View Dashboard, Edit Schema, API Keys, Open API, and Settings.
Build status badge (hosted plans only) and the subdomain appear on the right.
Health dot (hosted plans only): a colored dot reflecting deployment health.

Understand service status

The list displays separate indicators for the service lifecycle, latest build, and deployment health. An Error value describes a build; it does not change the service lifecycle status.

Service status (the badge next to the name): the lifecycle state of the service record:

Status	Meaning
Active	Live/in-use service
Draft	Not yet finalized
Archived	Retired

Build status (hosted plans only, right side of the card): the state of the most recent build/provision:

Category	Examples	Color
Ready	build complete	green
Building / in progress	scaffolding, provisioning, migrating	yellow (pulsing)
Error	a failed build	red
Intermediate	`DatabaseProvisioned`, `Scaffolded`, `StackCreated`, …	blue
New / pending	not started	neutral

Deployment health (hosted plans only, the dot before the name): the state of the active deployment: Live (green), Deploying (yellow, pulsing), Failed (red), Inactive/Not deployed (muted).

Empty and loading states

Loading: cards render as skeleton placeholders while services load.
No services in the workspace: a welcome state (Welcome to {workspace}) prompting you to create your first service, with the Create Service button.
No matches for the current filters: a “No services match your filters” state with a Clear all filters button.

Create service

The Create Service button (header, or the empty-state button when the workspace has no services) navigates to /{workspace}/services/new. Creating a service requires an active workspace; the button is always available to workspace members from this view.

Service Management: creating, configuring, and deleting services
Dashboard
API Keys