Provenance history for a record

GET

https://api.aventure.vc/v1/provenance/history

GET

/v1/provenance/history

$ curl -G https://api.aventure.vc/v1/provenance/history \
>      -H "Authorization: Bearer <token>" \
>      -d tableName=entity

1 {
2   "content": [
3     {
4       "changes": [
5         {
6           "fieldName": "string",
7           "newPresent": true,
8           "oldPresent": true,
9           "newValue": "string",
10           "oldValue": "string"
11         }
12       ],
13       "effectiveAt": "2024-01-15T09:30:00Z",
14       "eventId": "string",
15       "id": 1,
16       "operation": "insert",
17       "recordId": "string",
18       "source": {
19         "sourceDetail": "aventure.vc",
20         "sourceType": "aventureStaff",
21         "actorType": "agent",
22         "agentChassis": "codex-cli",
23         "agentModel": "string",
24         "sourceProvider": "TechCrunch",
25         "sourceProviderId": "tc-2026-05-20-example-round",
26         "sourceProviderSlug": "example-round"
27       },
28       "status": "unconfirmed",
29       "tableName": "entity",
30       "actor": {
31         "displayName": "string",
32         "type": "agent",
33         "agent": {
34           "chassis": "claude-code",
35           "model": "string",
36           "modelFamily": "claude"
37         },
38         "employeeDisplayName": "string",
39         "employeeUserId": "string"
40       },
41       "changedBy": "string",
42       "entityId": "string",
43       "personId": "string"
44     }
45   ],
46   "empty": true,
47   "first": true,
48   "last": true,
49   "number": 1,
50   "numberOfElements": 1,
51   "pageable": {
52     "offset": 1,
53     "pageNumber": 1,
54     "pageSize": 1,
55     "paged": true,
56     "sort": {
57       "empty": true,
58       "sorted": true,
59       "unsorted": true
60     },
61     "unpaged": true
62   },
63   "size": 1,
64   "sort": {
65     "empty": true,
66     "sorted": true,
67     "unsorted": true
68   },
69   "totalElements": 1,
70   "totalPages": 1
71 }

Returns paginated field-level provenance rows ordered by effectiveAt DESC.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

X-API-Keystring

Admin API key for system-to-system write operations

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

tableNameenumRequired

Tracked resource. Canonical form is the camelCase wire token (e.g. entity, newsArticle); the legacy Postgres table name (res_entity) is still accepted for backwards compatibility.

recordIdstringOptional

Record key of the tracked row (text)

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 25

The size of the page to be returned

sortlist of stringsOptionalDefaults to ["effectiveAt,DESC"]

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error