The identity and technical contract details declared by the specification.
WorkspaceCountySelection
object
One county selection — FIPS-shape only. Used by the append-county and workspace-provisioning request bodies. Callers supply statefips (2-digit) + countyfips (3…
2 properties
2 required
GlobalFeatureFlagsResponse
object
Every registered feature toggle with its global default + override count.
1 property
1 required
AdminWorkspaceDetailResponse
object
Full workspace detail response for admin view.
12 properties
12 required
AdminCreditUserUsageItem
object
Per-user credit usage in a workspace.
4 properties
4 required
AdminAuditLogResponse
object
Response schema for a single audit log entry.
11 properties
11 required
SkillResponse
object
A skill as returned to clients (full record, including body).
10 properties
7 required
ValidationError
object
5 properties
3 required
AdminWorkspaceProvisionRequest
object
Request body for provisioning a new workspace end-to-end. Wraps AdminWorkspaceService.provisionworkspacewithcounties: creates the Neon sandbox and seeds worksp…
4 properties
2 required
AppendCountyRequest
object
Request body for appending one county to an existing workspace sandbox.
2 properties
2 required
AdminExampleProjectListItem
object
Summary schema for example project list items.
5 properties
5 required
AdminProjectListItem
object
Summary schema for project list items in admin views.
8 properties
5 required
AdminWorkspaceUpdateRequest
object
Request schema for updating workspace fields. All fields optional; uses excludeunset semantics. Rejects unknown fields with 422 — legacy callers sending the re…
1 property
FeatureToggleUpdateRequest
object
Request to flip a single feature toggle for a workspace.
2 properties
2 required
AdminKnowledgeApplyRunResponse
object
What an applied run changed, plus the run-marker audit row's id.
4 properties
4 required
AdminDeliveryStatusResponse
object
Status of a cross-branch delivery workflow: PENDING | SUCCESS | FAILURE.
1 property
1 required
GlobalFeatureFlagItem
object
One feature toggle's platform-wide default and override count.
5 properties
5 required
HTTPValidationError
object
1 property
WorkspaceCountyResponse
object
A workspace's per-county sandbox-load state. countyname is the TIGER LSAD form (e.g. "Los Angeles County"); sourced from tigercounty.name via WorkspaceCountyRe…
10 properties
10 required
KnowledgeRunDelete
object
Delete an existing entry.
1 property
1 required
AdminWorkspaceListItem
object
Summary schema for workspace list items.
10 properties
10 required
AdminKnowledgeApplyRunRequest
object
One populate-knowledge run, applied atomically to a single workspace. The item shapes (with title/content caps) are the domain run models; the audit actor is t…
5 properties
2 required
MissingCountyCoverageDetail
object
409 detail payload for the duplicate endpoint's county-coverage gate.
2 properties
1 required
AdminAddCreditsRequest
object
Request schema for adding credits to a workspace.
1 property
1 required
KnowledgeScope
string
Tier a knowledge entry applies to. Resolution is additive and ordered user - workspace — precedence is ordering only, not override (no shadowing in v1). "Syste…
AdminProjectListResponse
object
Response schema for admin project list endpoints.
2 properties
2 required
KnowledgeRunCreate
object
One entry to create: ownerid is a user id or workspace id per scope.
4 properties
4 required
KnowledgeRunUpdate
object
Replace an existing entry's title + content.
3 properties
3 required
AdminSetCreditsRequest
object
Request schema for setting available credits to an exact value.
1 property
1 required
AdminCreditsSummaryResponse
object
Response schema for workspace credit summary with per-user breakdown.
4 properties
4 required
AdminAuditLogListResponse
object
Paginated response for audit log queries.
4 properties
4 required
ResetFeatureOverridesResponse
object
Result from clearing every per-workspace override for one feature.
2 properties
2 required
AdminCreateUserRequest
object
Request schema for creating a new user account. Rejects unknown fields with 422 — legacy callers sending the removed createworkspaceallowedgeographies key shou…
9 properties
3 required
ProjectLockStatus
object
Status of the project editing lock.
6 properties
1 required
MissingCounty
object
A county the source project covers but the target workspace lacks.
2 properties
2 required
AdminUserListResponse
object
Response schema for user list endpoint.
2 properties
2 required
AdminSendInviteResponse
object
Response schema for send invite email endpoint.
2 properties
2 required
RetellConfigUpdateRequest
object
Partial update for per-workspace Retell config (internal admin only). Pass an explicit null to clear an override (the dispatch path then falls back to env defa…
7 properties
AdminStatsResponse
object
Summary statistics for the admin dashboard.
4 properties
4 required
AdminSkillDraftRequest
object
Draft a system skill from a plain-language description (no persistence). current carry an existing draft so prompt can be read as revision feedback rather than…
4 properties
1 required
AdminDuplicationLogEntry
object
One recent duplication for the admin tracker. status is PENDING | SUCCESS | FAILURE. Synchronous user duplications are always SUCCESS (logged after the copy co…
7 properties
7 required
AdminProjectSearchResult
object
Search result item for project search.
7 properties
7 required
AdminKnowledgeRunCursorResponse
object
Refresh cursor for a workspace's populate-knowledge runs. meetingsthrough is the opaque ISO-8601 string from the newest run marker's metadata; runs counts all…
3 properties
3 required
KnowledgeRunProvenance
object
Provenance stamped into every audit row a knowledge run writes. meetingsthrough is the refresh cursor: the latest source meeting a run ingested. A later run re…
3 properties
2 required
AdminUserUpdateRequest
object
Request schema for updating user fields.
5 properties
AdminSkillDraftResponse
object
A drafted skill's three authored fields, for pre-filling the editor.
3 properties
3 required
KnowledgeEntryResponse
object
A titled knowledge entry as returned to clients.
9 properties
7 required
AdminUserListItem
object
Summary schema for user list items.
12 properties
12 required
AdminDuplicateProjectResponse
object
Response schema for the duplicate (workspace delivery) endpoint. Delivery is a durable cross-Neon-branch workflow that returns only a workflowid; the delivered…
1 property
1 required
AdminProjectPreviewResponse
object
Response schema for project preview endpoint.
6 properties
6 required
WorkspaceCountyLoadStatus
string
Load status for a workspace-county pair. Lifecycle: provisioning (initial — set by workspace standup before the Neon project is ready) → pending (set by provis…
AvailableCountyResponse
object
A county available to load (not yet in this workspace). countyname is the TIGER LSAD form (e.g. "Los Angeles County") populated from the picker's AvailableCoun…
4 properties
4 required
SkillScope
string
Tier a skill applies to. Unlike KnowledgeScope (user/workspace only), skills add a system scope: globally-available skills that are read-only through the publi…
AdminSkillWriteRequest
object
Create or replace a MAIA-curated (scope=system) skill. workspaceids sets availability on both create and update: empty is a global skill (visible to every work…
5 properties
3 required
AdminWorkspaceMemberItem
object
Member summary for workspace detail view.
9 properties
9 required
AdminUserDetailResponse
object
Full user detail response for admin view.
17 properties
17 required
AdminKnowledgeUpdateRequest
object
Replace an entry's title + content.
2 properties
2 required
AdminWorkspaceListResponse
object
Response schema for workspace list endpoint.
2 properties
2 required
AdminKnowledgeCreateRequest
object
Create a titled entry at scope for the target ownerid. ownerid is the target user id (user scope) or workspace id (workspace scope).
4 properties
4 required
AdminMoveWorkspaceRequest
object
Request schema for moving a user to a different workspace.
1 property
1 required
FeatureOverrideWorkspaceItem
object
One workspace overriding a feature, with its current stored value.
3 properties
3 required
FeatureTogglesResponse
object
All governable feature toggles for a workspace (registry + overrides).
1 property
1 required
AdminDuplicateProjectRequest
object
Request schema for delivering a curated project to a workspace.
2 properties
1 required
StateOption
object
A US state available for geography restriction.
2 properties
2 required
MissingCountyCoverageResponse
object
Wire shape of the county-coverage 409. FastAPI serializes HTTPException(detail=...) as {"detail": ...}, so the documented response body must carry the wrapper…
1 property
1 required
AdminExampleProjectListResponse
object
Response schema for example project list endpoint.
2 properties
2 required
RetellConfigResponse
object
Per-workspace Retell account config. Secrets returned as last-4 masked hints only — never the decrypted value.
7 properties
SetGlobalFlagDefaultRequest
object
Request to set the platform-wide default for one feature toggle.
1 property
1 required
AdminDuplicationLogResponse
object
Recent duplications, newest first, for the admin tracker panel.
1 property
1 required
CountyOption
object
A FIPS county available for geography restriction.
3 properties
3 required
FeatureToggleItem
object
One governable feature toggle and its effective state for a workspace. enabled is the resolved on/off (override ?? global ?? seed). isoverride flags whether th…
6 properties
6 required
FeatureOverridesResponse
object
Workspaces that override one feature (deviate from the global default).
2 properties
2 required
AdminProjectSearchResponse
object
Response schema for project search endpoint.
1 property
1 required
AdminLayerSummary
object
Layer summary for project preview.
4 properties
4 required
AdminSkillResponse
object
A curated skill as returned to the internal admin catalog. Adds the workspaceids availability set, which the public SkillResponse deliberately omits: for a ski…
11 properties
7 required
GeographyOptionsResponse
object
Available geography options for workspace restriction.
2 properties
2 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Maia-analytics publishes across the network.