Read a business definition's revision history

curl --request GET \
  --url https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions \
  --header 'Authorization: Bearer <token>' \
  --header 'X-MeshQu-Tenant-Id: <api-key>'

import requests

url = "https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions"

headers = {
    "Authorization": "Bearer <token>",
    "X-MeshQu-Tenant-Id": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-MeshQu-Tenant-Id': '<api-key>'}
};

fetch('https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-MeshQu-Tenant-Id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-MeshQu-Tenant-Id", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions")
  .header("Authorization", "Bearer <token>")
  .header("X-MeshQu-Tenant-Id", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-MeshQu-Tenant-Id"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "field_name": "<string>",
  "items": [
    {
      "revision": 123,
      "label": "<string>",
      "value_type": "number",
      "change_kind": "declare",
      "changed_by": "<string>",
      "changed_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "unit": "<string>",
      "owner": "<string>",
      "choices": [
        {
          "code": "<string>",
          "label": "<string>"
        }
      ]
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<unknown>"
  },
  "correlation_id": "<string>"
}

Fields

Read a business definition's revision history

Returns every recorded revision of one definition, OLDEST FIRST, each carrying the full snapshot that write left in place rather than a diff.

Each entry RECORDS what the definition meant, who wrote it and when. It PROVES nothing — no entry is signed or hashed, none enters a digest or a receipt, and a recorded owner is a name rather than an authority. A choices domain in an entry is business metadata that never edited any rule’s allowed values.

An EMPTY list is a normal answer, not an error, and means one of two things this endpoint cannot tell apart: the key has no declared definition, or it was declared before revision history existed and has had no definition write since. No backfill was run, so a point-in-time read before a definition’s first recorded revision reports “not defined at the time” rather than showing today’s meaning as if it had applied then.

GET

fields

definitions

{field_name}

revisions

Read a business definition's revision history

curl --request GET \
  --url https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions \
  --header 'Authorization: Bearer <token>' \
  --header 'X-MeshQu-Tenant-Id: <api-key>'

import requests

url = "https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions"

headers = {
    "Authorization": "Bearer <token>",
    "X-MeshQu-Tenant-Id": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-MeshQu-Tenant-Id': '<api-key>'}
};

fetch('https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-MeshQu-Tenant-Id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-MeshQu-Tenant-Id", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions")
  .header("Authorization", "Bearer <token>")
  .header("X-MeshQu-Tenant-Id", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.meshqu.com/v1/fields/definitions/{field_name}/revisions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-MeshQu-Tenant-Id"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "field_name": "<string>",
  "items": [
    {
      "revision": 123,
      "label": "<string>",
      "value_type": "number",
      "change_kind": "declare",
      "changed_by": "<string>",
      "changed_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "unit": "<string>",
      "owner": "<string>",
      "choices": [
        {
          "code": "<string>",
          "label": "<string>"
        }
      ]
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<unknown>"
  },
  "correlation_id": "<string>"
}

Authorizations

Authorization

string

header

required

MeshQu API key passed as a bearer token: Authorization: Bearer mqu_…. Mint one in the console (Settings → API keys).

X-MeshQu-Tenant-Id

string

header

required

Tenant UUID for multi-tenant isolation. Required on all authenticated routes — validated before authentication (middleware/tenant.ts), so a missing or non-UUID header returns 400 (MISSING_TENANT_ID / INVALID_TENANT_ID) before the API key is checked.

Path Parameters

field_name

string

required

The canonical key, e.g. vendor.

Response

Default Response

field_name

string

required

items

object[]

required

The full history, OLDEST FIRST. One entry per definition write, each carrying the whole snapshot that write left in place rather than a diff. RECORDS what the definition meant, who wrote it and when; PROVES nothing — no entry is signed or hashed and none enters a digest or a receipt. EMPTY is a legitimate answer for a definition declared before BC-02: no backfill ran (contract §5), so such a row has no history until its first BC-02 write, and a point-in-time read before that instant reports "not defined at the time" rather than showing today's meaning as if it had applied.

Show child attributes

Getting Started

Concepts

API Reference

SDK

Guides

Recipes

Security

Meta

Read a business definition's revision history

Authorizations

Path Parameters

Response