← Meridian workspace

Developer reference

Use a workspace session, bearer token, X-API-Key, or X-Session-Token. Lists are scoped to your workspace. Only administrators may create vendors or export organization-wide audit records; only analysts and administrators may approve invoices. Request creators and workspace administrators manage request cancellation; approvers perform review duties. Purchases must have positive quantities and must be paid before dispatch. Coupons apply once per order.

OpenAPI schema · Postman collection · Protobuf service definition · SOAP WSDL · SOAP v2 WSDL · Build metadata

Real-time integrations

GraphQL queries and mutations use POST /graphql; subscriptions use the graphql-transport-ws protocol at /graphql/ws with authorization in connection parameters. Collaboration uses /ws/collaboration?access_token=… and envelopes {"op":"subscribe","projectId":"…"}, {"op":"note","projectId":"…","body":"Delivery schedule confirmed."}. Project events use /api/events?projectId=… and support Last-Event-ID resume. SOAP uses session or API authentication at /soap and /soap/v2. The v2 collaboration socket is /ws/v2; use the workspace origin when opening it.

Mobile clients may exchange access tokens through /api/auth/token-exchange using client workspace-mobile. Application mTLS is unavailable through this public deployment.

Public transport availability

Public HTTPS supports the web application, REST, GraphQL, WebSocket, SSE and SOAP. Native gRPC and application mTLS are unavailable through this deployment.

Vehicle operations

Open vehicle operations. Both workspaces use the same account and session. Reconditioning approvals require an independent reviewer. Material changes require renewed approval. Payment events are generated by the local partner simulator.

Workspace operations

MethodRouteOperation
POST/api/auth/loginSign in
GET/api/auth/sessionStart a browser session
POST/api/auth/refreshRefresh access
POST/api/auth/logoutSign out
POST/api/auth/forgotRequest account recovery
GET/api/auth/recovery-previewPreview current test identity recovery mailbox
POST/api/auth/resetRecover account
GET/api/meCurrent identity
GET/api/mtls/meCertificate identity
GET/api/workspace/casesList service cases
GET/api/workspace/cases/{id}Service case details
GET/api/workspace/cases/{id}/notesService case notes
GET/api/workspace/requestsList workspace requests
POST/api/workspace/requests/{id}/cancelCancel workspace request
GET/api/projectsList workspace projects
GET/api/invoicesList invoices
GET/api/invoices/{id}Invoice details
POST/api/invoices/{id}/approveApprove invoice
GET/api/projects/{id}/commentsProject discussion
POST/api/projects/{id}/commentsPost discussion
POST/api/profileUpdate profile
POST/api/admin/vendorsCreate vendor (administrator operation)
POST/api/directory/searchSearch staff directory
POST/api/diagnostics/resolveResolve integration hostname
GET/api/integrations/configPartner integration settings
POST/api/integrations/previewPreview partner resource
POST/api/integrations/catalogImport partner quote
POST/api/reportsCreate invoice export
GET/api/reports/{id}Export status
GET/api/reports/{id}/downloadDownload export
POST/api/reports/previewPreview report layout
POST/api/preferences/importImport nested preferences
GET/api/preferences/policyCurrent export policy
POST/api/imports/sessionImport session
GET/api/catalogBrowse supplies
GET/api/ordersOrder history
POST/api/ordersCreate purchase request
POST/api/orders/{id}/checkoutRequest checkout
POST/api/orders/{id}/fulfillDispatch paid order
POST/api/payments/confirmProcess payment confirmation
POST/api/exports/bulkCreate copies of workspace export
GET/api/audit/exportExport audit records (administrator operation)
GET/api/eventsSubscribe to project event stream
POST/api/text/formatFormat display text
POST/api/auth/token-exchangeExchange mobile access token
GET/api/v2/invoicesList invoices (v2)
GET/api/v2/invoices/{id}Invoice details (v2)
GET/api/v2/searchSearch workspace (v2)
POST/api/v2/profileUpdate profile (v2)
POST/api/v2/admin/vendorsCreate vendor (v2)
POST/api/v2/directory/searchSearch staff directory (v2)
POST/api/v2/diagnostics/resolveResolve integration hostname (v2)
POST/api/v2/integrations/previewPreview partner resource (v2)
POST/api/v2/reports/previewPreview report layout (v2)
POST/api/v2/imports/sessionImport session (v2)
POST/api/v2/preferences/importImport nested preferences (v2)
POST/api/v2/payments/confirmProcess payment confirmation (v2)
GET/api/v2/eventsSubscribe to project event stream (v2)
GET/api/assistant/configAssistant configuration
POST/api/assistant/documentsImport partner knowledge
POST/api/assistant/chatDiscuss project with assistant
GET/api/workspace/preferencesNotification and currency preferences
POST/api/workspace/preferencesSave notification preferences
GET/api/workspace/preferences/updateLegacy notification preference link
GET/browser/connectorEmbedded workspace notification settings
GET/browser/connector.jsWorkspace connector client
GET/identity/.well-known/openid-configurationLocal identity discovery
GET/identity/jwksLocal identity public keys
GET/identity/:issuer/authorizeAuthorize workspace application
POST/identity/tokenExchange an application authorization code
GET/api/identity/resources/:audienceRead an application resource
POST/api/identity/dispatchRecord an authorized transport dispatch
GET/identity/callbackApplication authorization return
GET/identity/report-callbackApplication authorization return
GET/api/filesList workspace attachment metadata
POST/api/filesUpload a small UTF-8 fixture attachment
PUT/api/files/:idReplace an attachment version
POST/api/files/:id/reviewRecord an attachment review for its current version
GET/api/files/:id/downloadDownload a reviewed workspace attachment
GET/api/files/:id/previewPreview a reviewed attachment in an inert sandbox
GET/api/file-storageResolve a path inside the synthetic attachment store
POST/api/account-links/challengesBegin linking a fictional fleet-provider identity
POST/api/account-linksComplete a fictional fleet-provider account link
GET/api/account-linksList linked provider accounts
GET/api/partner-workspaceRead acquisition notes from the linked fictional provider
GET/api/workspace-summaryRead a cached workspace procurement summary
POST/api/workspace-summary/refreshInvalidate cached summaries for an authorized workspace
POST/api/export-jobsQueue a workspace transport export
GET/api/export-jobs/:idRead the status of an export requested by this identity
GET/api/export-jobs/:id/downloadDownload a completed workspace export
POST/api/importsImport bounded transport records for background report and index processing
GET/api/imports/:idRead workspace import processing status
GET/api/imports/:id/reportDownload a processed data-only transport report
GET/api/search-indexSearch transport records produced by background indexing
GET/api/invitations/receivedList invitations addressed to the current identity
POST/api/invitationsInvite an identity into the current workspace
GET/api/invitations/:idRead an invitation landing-page summary
POST/api/invitations/:id/acceptAccept a current workspace invitation
GET/api/membershipsList this identity’s workspace memberships
POST/api/memberships/:id/revokeRemove a workspace membership
PATCH/api/memberships/:idChange a workspace membership role
GET/api/collaboration/messagesRead current workspace collaboration messages
POST/api/collaboration/messagesPost a transport collaboration update
GET/api/collaboration/eventsSubscribe to workspace collaboration events over SSE
GET/api/document-eventsRead acquisition document notification metadata
POST/api/document-capabilitiesIssue a short-lived acquisition document review capability
GET/api/documents/downloadRedeem a signed acquisition document review capability
GET/api/commerce/overviewPurchasing, reservations, deposits and mock payment workflows
GET/api/commerce/invoicesList workspace reconditioning invoices
POST/api/commerce/invoicesSubmit a reconditioning invoice
GET/api/commerce/invoices/:idRead a workspace invoice and its approval
PATCH/api/commerce/invoices/:idUpdate invoice amount, payment destination and attachments
POST/api/commerce/invoices/:id/recallRecall approval before revising an invoice
GET/api/commerce/delegationsList workspace purchasing delegations
POST/api/commerce/delegationsDelegate invoice approval duties within the workspace
DELETE/api/commerce/delegations/:idRevoke a purchasing delegation
POST/api/commerce/invoices/:id/approveApprove a submitted reconditioning invoice
POST/api/commerce/invoices/:id/settleSettle an approved invoice in the local payment ledger
GET/api/commerce/commitmentsList acquisition and transport commitments
POST/api/commerce/commitmentsRecord an acquisition or transport commitment
GET/api/commerce/depositsList settled fictional vehicle deposits
GET/api/commerce/deposits/:id/refundsList local deposit refunds
POST/api/commerce/deposits/:id/refundsIssue a partial refund in the local ledger
GET/api/commerce/vehiclesList fictional vehicle inventory
GET/api/commerce/reservationsList workspace vehicle reservations
POST/api/commerce/vehicles/:id/reservationsReserve a fictional inventory vehicle
POST/api/commerce/reservations/:id/cancelCancel an owned vehicle reservation
GET/api/commerce/ordersList local transport and acquisition payment orders
POST/api/commerce/ordersCreate a synthetic transport dispatch order
GET/api/commerce/orders/:idRead a local transport payment order
PATCH/api/commerce/orders/:idRevise an unfulfilled dispatch and request a fresh payment
GET/api/commerce/orders/:id/provider-eventsList provider events for an owned dispatch order
POST/api/commerce/orders/:id/simulate-paymentAsk the local payment simulator to produce a bound payment event
POST/api/commerce/provider-events/:id/deliverDeliver an existing signed local provider event
POST/api/commerce/webhooks/paymentReceive a signed local provider notification
POST/api/commerce/orders/:id/dispatchRelease a paid fictional transport dispatch
GET/api/workspaceWorkspace home