MATIH Platform is in active MVP development. Documentation reflects current implementation status.
7. Tenant Lifecycle
Platform Deployment
Current Deployment

Current Deployment

The current deployment endpoint returns the active platform version information, including the image tag, git metadata, and environment details. This is used by the platform UI, health checks, and monitoring systems to display version information.


Querying Current Version

GET /api/v1/platform/deployments/current

Returns PlatformVersionInfo:

{
  "imageTag": "v2.1.0-abc1234",
  "acrRegistry": "matih.azurecr.io",
  "gitCommit": "abc1234",
  "gitBranch": "main",
  "environment": "dev",
  "deployedAt": "2026-02-12T10:00:00Z",
  "deployedBy": "cd-pipeline",
  "isVersioned": true
}

Version Identification

FieldDescription
imageTagPrimary version identifier used across all services
gitCommitShort SHA for traceability to source code
gitBranchBranch from which the build was created
isVersionedTrue if the tag follows semantic versioning

Querying by Tag

To look up a specific deployment by its image tag:

GET /api/v1/platform/deployments/tag/v2.1.0-abc1234

To check if a deployment exists without fetching details:

GET /api/v1/platform/deployments/tag/v2.1.0-abc1234/exists

Returns {"exists": true} or {"exists": false}.


Querying by Branch

To see all deployments from a specific branch:

GET /api/v1/platform/deployments/branch/main?limit=10

Returns the most recent deployments from the specified branch, useful for tracking feature branch deployments in development environments.


Service Versions

The serviceVersions map provides per-service version tracking within a deployment:

{
  "ai-service": "v2.1.0",
  "query-engine": "v2.1.0",
  "catalog-service": "v2.1.0",
  "tenant-service": "v2.1.0",
  "iam-service": "v2.1.0"
}

This enables identification of which services were updated in each deployment.