Maia-analytics chat API
The chat API from Maia-analytics — 8 operation(s) for chat.
Maia-analytics chat API is one of 33 APIs that Maia-analytics publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Chat. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 8 operations across 8 paths, and defines 137 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.
Requests are made against the base URL https://api.maia-analytics.com.
8 operations
8 paths
137 schemas
4 GET4 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Maia-analytics chat API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (FirebaseAuthMiddleware).
Paths & Operations 8
Across 8 paths, the API surfaces 8 operations — 4 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.
chat 8
POST
/api/v1/chat/feedback
Submit Chat Feedback
GET
/api/v1/chat/models
List Picker Models
POST
/api/v1/chat/stream
Chat Main Agent
POST
/api/v1/chat/stream/resume
Resume Chat Main Agent
POST
/api/v1/chat/chat/interrupt
Interrupt Chat
GET
/api/v1/chat/schemas
Expose Schemas
GET
/api/v1/chat/archives/{project_id}
Get Chat Archives
GET
/api/v1/chat/archives/{project_id}/{archive_id}
Get Chat Archive Content
Schemas 137
The contract defines 137 schemas that model the data the API accepts and returns. The most detailed are ContactModel (58 properties), SchemaExposure (38 properties), LayerModel (24 properties), ModelResponse (14 properties). Each schema is shown below with its type and property counts.
ThinkingPart
object
A thinking response from a model.
6 properties
1 required
AudioUrl
object
A URL to an audio file.
6 properties
3 required
AgeRange
object
Age range from PDL. Can represent exact age (min == max) or range.
5 properties
LayerStateChangedEvent
object
Fired after a layer metadata mutation commits (create / delete / rename / restyle / recolor), over the same per-user channel — the layer sibling of ViewStateCh…
4 properties
1 required
ValidationError
object
5 properties
3 required
ChatStopReason
string
Why a chat run was stopped — the cooperative flag's reason taxonomy. Carried in the Redis stop flag and, on the monitor's escalation path, in the durable stop…
StreamChatUserMessage
object
The acting user's prompt, emitted as the FIRST durable stream event. The live sender already rendered its own message optimistically, so it ignores this echo.…
4 properties
1 required
SkillPlanPhase
object
2 properties
2 required
NativeToolReturnPart
object
A tool return message from a native tool. For native tools with a stable cross-provider shape (currently toolsearch), a NativeToolReturnPart may be promoted to…
10 properties
2 required
TenureRange
object
Job tenure range representing when someone started at their current position/company. Used for employment duration (e.g., via PDL data). Can represent exact ye…
4 properties
PDLLocation
object
Location information from PDL.
10 properties
StreamToolCallStart
object
Schema for when a tool call begins.
5 properties
3 required
ColumnDataType
string
Optional frontend type hint for a layer column.
UnprocessableQueryReason
string
OwnerResidentialMailingAddressModel
object
A resolved residential mailing address for a parcel's decision-making owner.
12 properties
1 required
ModelResponse
object
A response from a model, e.g. a message from the model to the Pydantic AI app.
14 properties
1 required
EnrichmentStatusChangedEvent
object
Fired when one enrichment workflow reaches a terminal state. Unlike CreditStateChangedEvent this is payload-rich. It carries: - workflowid — the client registr…
7 properties
5 required
ToolSearchReturnPart
object
Typed view of a [ToolReturnPart][pydanticai.messages.ToolReturnPart] for the local searchtools function return. Used on the local-fallback path (and as the syn…
8 properties
1 required
StreamWebSearchStatus
object
Schema for web search status updates from built-in tools.
5 properties
2 required
ChatModelOption
object
One curated model-picker option (see GET /chat/models).
3 properties
3 required
UserPromptPart
object
A user prompt, generally written by the end user. Content comes from the userprompt parameter of [Agent.run][pydanticai.agent.AbstractAgent.run], [Agent.runsyn…
3 properties
1 required
ResourceType
string
Enum for different resource types that can be referenced in chat.
MortgageOpenLien
object
One currently-open mortgage against the property.
14 properties
ArchiveContentResponseSchema
object
Schema for one archive's message bodies, fetched on demand.
1 property
1 required
PDLProfile
object
Social profile from PDL.
4 properties
1 required
BinaryContent
object
Binary content, e.g. an audio or image file.
5 properties
3 required
ActionType
string
Enum for different action types in the system.
ErrorDetails
object
6 properties
4 required
ProjectTitleSource
string
Provenance + lifecycle for the project's name field. Replaces an em-dash string heuristic (" — " not in project.name) that gated whether the sandbox auto-title…
ContactModel
object
Person contact model parsed from PDL Person Search API. This model represents a person with their contact information, current job, work history, and education.
58 properties
ToolReturnContent
ToolSearchMatch
object
A single match in a tool-search result.
2 properties
2 required
ResourceOperation
string
Enum for operations that can be performed on resources.
ViewOfferPreview
object
2 properties
2 required
LayerColumn
object
The resolved, persisted shape — what gets stored on layers.columns and surfaced to the frontend. Visibility and ordering live on the view (view.layerColumnVisi…
9 properties
4 required
ConfirmQuestionPayload
object
8 properties
1 required
QueryParseResponse
object
Lightweight real-time parse of a user query, used for live preview chips.
4 properties
1 required
QueryParseItem
object
A single item identified from a user query — either a layer or an enrichment.
4 properties
3 required
LoadCapabilityArgs
object
Typed arguments for a loadcapability tool call.
1 property
1 required
LeaseEscalationType
string
ChatFeedbackResponse
object
Schema for chat feedback responses.
2 properties
PDLTitle
object
Job title information from PDL.
5 properties
NativeToolSearchCallPart
object
Typed view of a [NativeToolCallPart][pydanticai.messages.NativeToolCallPart] for tool search. Used on the native server-side tool-search path (Anthropic BM25/r…
8 properties
SkillPlanPhaseStatus
string
ResourceReference
object
Reference to a resource created or modified during chat.
7 properties
4 required
StreamChatRetry
object
A dead model stream is being transparently retried (MAIA-2254). Emitted mid-stream when a transient transport failure (or stall) killed the in-flight model res…
3 properties
1 required
ExpenseStructure
string
StreamChatCaughtUp
object
A resumed reader has drained the persisted backlog; frames after this are live output. Synthesized per-connection by the resume path at the replay/live boundar…
2 properties
ChatArchiveMetadataResponseSchema
object
Schema for the bounded chat archive metadata response.
1 property
1 required
ProjectRenamedEvent
object
Fired when a project's name changes server-side, over the per-user channel. The trigger today is auto-title generation: a fire-and-forget task that generates a…
4 properties
3 required
RequirementsCheck
object
Tracks which key requirements from the query are satisfiable.
4 properties
4 required
CachePoint
object
A cache point marker for prompt caching. Can be inserted into UserPromptPart.content to mark cache boundaries. Models that don't support caching will filter th…
2 properties
ChatInterruptRequest
object
Schema for chat interrupt requests.
2 properties
1 required
SchemaExposure
object
Schema exposure model for all chat-related types. This endpoint exists solely to expose schemas to OpenAPI/TypeScript generation. These fields are never actual…
38 properties
StreamChatError
object
Schema for general streaming chat error event.
10 properties
1 required
MortgageInvoluntaryLien
object
One involuntary lien (tax lien, judgment, mechanic's lien): existence + type.
3 properties
ChatSummarizationCompletedEvent
object
Fired when a chat's background summarizeworkflow finishes persisting. Summarization runs as a fire-and-forget DBOS workflow after a turn crosses the context th…
2 properties
1 required
EnrichmentCitation
object
Metadata describing a cited source returned by an enrichment.
5 properties
ChatFeedbackRequest
object
Schema for chat feedback requests.
4 properties
2 required
CreateLayerFailure
object
Model for a layer creation failure.
1 property
1 required
CompactionPart
object
A compaction part that summarizes previous conversation history. Compaction parts contain an opaque or readable summary of prior messages, produced by provider…
5 properties
StreamChatComplete
object
Schema for streaming chat completion event.
11 properties
2 required
ReportActionsPayload
object
3 properties
2 required
EnrichmentModel
object
Enrichment model that combines both properties and chat history. This unified model simplifies the domain representation and aligns more closely with how data…
13 properties
4 required
MapFlyToEvent
object
Fired when the agent moves the map camera to a resolved feature, over the per-user channel — the reply to a "zoom to " request. Carries the envelope bbox ([min…
3 properties
2 required
StreamChatDelta
object
Schema for streaming chat content deltas.
3 properties
1 required
EnrichmentState
string
Enum representing the state of an enrichment value.
SelectQuestionPayload
object
4 properties
2 required
DocumentUrl
object
The URL of the document.
6 properties
3 required
RequestUsage
object
LLM usage associated with a single request. This is an implementation of genaiprices.types.AbstractUsage so it can be used to calculate the price of the reques…
8 properties
QueryParseItemKind
string
Whether a parsed item is a layer (from core dataset) or an enrichment.
ChatRequest
object
14 properties
2 required
ToolApprovalAnswer
object
The user's approve/decline for a pending tool call. message is wire-forward-compat: no UI affordance sends it yet (the card is approve/decline only), but the d…
3 properties
2 required
ToolSearchArgs
object
Typed arguments for a tool-search call. Carried on [NativeToolSearchCallPart.args][pydanticai.messages.NativeToolSearchCallPart.args] (native server-side path)…
1 property
1 required
FilePart
object
A file response from a model.
5 properties
1 required
RetryPromptPart
object
A message back to a model asking it to try again. This can be sent for a number of reasons: Pydantic validation of tool arguments failed, here content is deriv…
5 properties
1 required
MortgageValuationSummary
object
AVM-derived value and equity — modeled estimates, not recorded facts.
6 properties
ToolSearchCallPart
object
Typed view of a [ToolCallPart][pydanticai.messages.ToolCallPart] for the local searchtools function call. Used on the local-fallback path (and as the synthetic…
8 properties
OccupancyStatus
string
PDLCompany
object
Company information from PDL.
11 properties
PDLEducation
object
Education information from PDL.
7 properties
ModelRequest
object
A request generated by Pydantic AI and sent to a model, e.g. a message from the Pydantic AI app to the model.
7 properties
1 required
TenantLeaseConcise
object
Concise tenant / lease model optimized for REIT screens. Includes a small set of critical fields and computed helpers (lease duration, months remaining, rent d…
10 properties
PDLSchool
object
School information from PDL.
8 properties
ColumnProvenance
object
Where a column came from and how to look up its canonical metadata. sourcecolumn is the canonical Overture column path (e.g. names.primary, not the agent's SQL…
3 properties
1 required
CopyLayerParameters
object
Parameters for creating a layer from an Overture/core data table. Defines the source table, column selection, and filters used by the layer creation pipeline.…
3 properties
1 required
HTTPValidationError
object
1 property
VideoUrl
object
A URL to a video.
6 properties
3 required
StreamChatApprovalRequired
object
Terminal event for a run that ended awaiting tool approval (MAIA-2220). The agent issued a requiresapproval tool call (saveskill / updateskill) and the run end…
8 properties
3 required
StreamToolCallComplete
object
Schema for when a tool call completes.
6 properties
3 required
ViewStateChangedEvent
object
Fired after a project view mutation commits (create / update / filter / delete / column change), over the same per-user channel. Payload-rich + version-stamped…
4 properties
2 required
AttributionPayload
object
One trust-receipt entry. Carried under two metadata keys with the same shape: attribution (the reply ran a skill / applied a saved preference) and knowledgesav…
3 properties
2 required
EnrichmentValueBaseModel
object
Enrichment value domain model.
5 properties
LoadCapabilityReturnPart
object
Typed ToolReturnPart for the loadcapability tool.
8 properties
1 required
UploadedFile
object
A reference to a file uploaded to a provider's file storage by ID. This allows referencing files that have been uploaded via provider-specific file APIs rather…
6 properties
4 required
StreamSummarizationStatus
object
A follow-up send is waiting out the prior turn's summary finalization. Emitted once, before the send path starts polling for the summary child's slot release,…
3 properties
1 required
ThumbnailBounds
object
Bounding box for project thumbnail map rendering. Represents the geographic extent of project features for generating static map thumbnails via Mapbox.
4 properties
4 required
ColumnRole
string
Narrow detail-panel placement signal, orthogonal to semantictype. The one signal that cannot be derived from semantictype: parcel parval and improvval are both…
SystemPromptPart
object
A system prompt, generally written by the application developer. This gives the model context and guidance on how to respond.
4 properties
1 required
ArchiveMetadataSchema
object
Light metadata for a single archive, without message bodies.
5 properties
4 required
NativeToolCallPart
object
A tool call to a native tool. For native tools with a stable cross-provider shape (currently toolsearch), this base class can be promoted to a typed subclass w…
8 properties
1 required
ImageUrl
object
A URL to an image.
6 properties
3 required
ChatResumeRequest
object
Schema for re-attaching to a project's in-flight chat run (refresh-resume).
2 properties
1 required
SkillPlanPayload
object
2 properties
2 required
LoadCapabilityCallPart
object
Typed ToolCallPart for the loadcapability tool.
8 properties
ChatModelsResponse
object
Curated model-picker options for the chat composer dropdown.
1 property
1 required
NotEnoughContext
object
1 property
1 required
NativeToolSearchReturnPart
object
Typed view of a [NativeToolReturnPart][pydanticai.messages.NativeToolReturnPart] for tool search. Used on the native server-side tool-search path (Anthropic BM…
10 properties
1 required
SemanticType
string
What a column means — drives FE rendering and formatting. Independent from ColumnDataType (the storage type hint): a column can be datatype=number, semantictyp…
ToolSearchReturnContent
object
Typed return value of the framework-managed tool-search builtin. Carried on [NativeToolSearchReturnPart.content][pydanticai.messages.NativeToolSearchReturnPart…
2 properties
1 required
LayerModel
object
Model for a layer.
24 properties
9 required
MortgageProfileModel
object
The full mortgage & liens profile for one matched property.
13 properties
PendingEnrichmentRef
object
Reference to a skeleton enrichment that is still being configured.
3 properties
3 required
LoadCapabilityReturn
object
Typed return value for the loadcapability tool.
1 property
CreateLayerSuccess
object
Successful layer creation result with copy parameters.
4 properties
3 required
FeatureContext
object
Reference to a specific feature the user is viewing. Sent when the detail view is open so the agent knows which feature the user is talking about. Reused by @…
2 properties
2 required
StreamLLMProviderError
object
Schema for LLM provider-specific errors. A terminal model failure that already committed work finalizes on this frame rather than downgrading to a generic erro…
13 properties
3 required
ToolResourceResponse
object
Generic response model for tool/agent outputs. Structured response that includes a message and any resource references created or modified by the tool.
2 properties
1 required
MortgageForeclosureNotice
object
Pre-foreclosure filing detail; only present when a filing exists.
6 properties
SelectOption
object
3 properties
2 required
InteractiveQuestionAnswer
object
3 properties
3 required
MortgageRecorderEvidence
object
County-recorder evidence booleans. Input to a county-level coverage rate, never a per-property coverage verdict — a never-refinanced home and an uncovered coun…
3 properties
3 required
ToolReturnPart
object
A tool return message, this encodes the result of running a tool.
8 properties
2 required
UnprocessableQueryResult
object
Result returned when a query cannot be processed — invalid input, system limitation, or execution blocker.
4 properties
2 required
ColumnKind
string
Provenance discriminator for a layer column. source — column SELECTed directly from the canonical Overture table. merged — column joined in from another canoni…
InvokedSkillPayload
object
The catalog skill a user turn invoked, for the inline chip.
2 properties
2 required
StreamErrorCode
string
Stable taxonomy for generic stream errors. Clients branch on code for retry / toast / surface decisions; the free-form error message remains the user-visible s…
ToolApprovalRequest
object
The pending approval-gated tool call, as persisted for card rendering.
3 properties
3 required
PDLExperience
object
Work experience from PDL.
6 properties
StreamChatInterrupted
object
Schema for chat interruption event. newmessages carries the persisted partial (surfaced) so the live client renders a stopped turn exactly as a reload would —…
10 properties
4 required
StreamThinkingDelta
object
Schema for streaming thinking/reasoning content deltas.
3 properties
1 required
OwnershipDuration
object
Property ownership duration representing when ownership began. Used for property/parcel ownership (e.g., via deed records). Can represent exact year (min == ma…
4 properties
TextContent
object
String content that is tagged with additional metadata. This is useful for including metadata that can be accessed programmatically by the application, but is…
3 properties
1 required
ToolCallPart
object
A tool call from a model.
8 properties
1 required
StreamProjectCreated
object
Schema for project creation event, sent at stream start.
4 properties
1 required
TextPart
object
A plain text response from a model.
5 properties
1 required
ChatInterruptResponse
object
Schema for chat interrupt responses.
3 properties
3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Maia-analytics 12
Other APIs Maia-analytics publishes across the network.
Maia-analytics Ah API
Maia-analytics analytics API
Maia-analytics audit-log API
Maia-analytics auth API
Maia-analytics dial API
Maia-analytics enrichment API
Maia-analytics example-projects API
Maia-analytics favorite API
Maia-analytics feature-flags API
Maia-analytics filters API
Maia-analytics geographies API
Maia-analytics internal API
#Chat
Where this information came from
This is an independent, third-party profile of Maia-analytics chat API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.