Prudai Developer API: registers
The operations of this part (Registers).
Base URL https://api.prudai.com/v1. Logging in is in Login, scopes in Scopes and permissions, errors in Errors. Overview.
List organisation register tables
GET /v1/tables
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:read - Approval:
none, no extra step.
Parameters
include_deleted
One of:true,falselimit
min 1 · max 1000cursor
max length 10000knowledge_base_id
max length 100
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s "https://api.prudai.com/v1/tables" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo tables listCreate a typed register table (Owner or Admin)
POST /v1/tables
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409. Execution requires Idempotency-Key; exact request/grant retries return the stored result without running the write again.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Idempotency: send
Idempotency-Key; the same key with the same body does not run the action twice.
Parameters
dryRun
Validate and preview with no persistent changes. One of:true,falseIdempotency-Keyrequired
Required for execution; exact retries replay the stored result. Reusing the key for changed arguments is refused before approval. A preview needs no key. max length 255
Body
JSON, required.
namerequired
max length 200description
max length 10000knowledge_base_id
max length 100 · may benullschemarequiredschema[].keyrequired
pattern^[a-zA-Z][a-zA-Z0-9_]{0,62}$schema[].labelrequired
max length 200schema[].typerequired
One of:text,number,amount,percentage,date,boolean,choice,multichoice,party,linkschema[].optionsschema[].required
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
201 | Created. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "description": "string", "knowledge_base_id": "string", "schema": [ { "key": "string", "label": "string", "type": "text", "options": [ "string" ], "required": false } ] }'prudai leo tables createRead one register table
GET /v1/tables/{id}
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:read - Approval:
none, no extra step.
Parameters
idrequiredinclude_deleted
One of:true,false
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s "https://api.prudai.com/v1/tables/<id>" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo tables getChange table fields with a lossless conversion report (Owner or Admin)
PATCH /v1/tables/{id}
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409. A failed field conversion returns 409 with per-field failed counts and preserves all data.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Concurrent changes: send
If-Matchwith the version you read.
Parameters
idrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, required.
name
max length 200description
max length 10000knowledge_base_id
max length 100 · may benullschemaschema[].keyrequired
pattern^[a-zA-Z][a-zA-Z0-9_]{0,62}$schema[].labelrequired
max length 200schema[].typerequired
One of:text,number,amount,percentage,date,boolean,choice,multichoice,party,linkschema[].optionsschema[].requiredversion
min 1
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X PATCH "https://api.prudai.com/v1/tables/<id>" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "description": "string", "knowledge_base_id": "string", "schema": [ { "key": "string", "label": "string", "type": "text", "options": [ "string" ], "required": false } ], "version": 1 }'prudai leo tables updateSoft-delete a register table (Owner or Admin)
DELETE /v1/tables/{id}
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:delete - Approval:
review, a second person or role approves. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Concurrent changes: send
If-Matchwith the version you read. - Deleting is soft; see Conventions.
Parameters
idrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optional.
version
min 1
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X DELETE "https://api.prudai.com/v1/tables/<id>" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "version": 1 }'prudai leo tables deleteExport records as CSV, XLSX or JSON in an envelope
GET /v1/tables/{id}/export
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. data contains format, content, encoding (utf8 or base64) and count; exports the full filtered result up to 100,000 records. Cursor and limit are not supported and are rejected.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:read - Approval:
none, no extra step.
Parameters
idrequiredinclude_deleted
One of:true,falsefilters
JSON array of TableFilter objects. max length 20000sort
JSON array of TableSort objects. max length 20000format
One of:csv,xlsx,json· default:"csv"
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s "https://api.prudai.com/v1/tables/<id>/export" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo tables exportPreview or import CSV/XLSX with column mapping
POST /v1/tables/{id}/import
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409. dryRun=true returns count, sample and row errors; apply waits for the central approval grant. Execution requires Idempotency-Key; exact request/grant retries return the stored result without running the write again.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Idempotency: send
Idempotency-Key; the same key with the same body does not run the action twice.
Parameters
idrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIdempotency-Keyrequired
Required for execution; exact retries replay the stored result. Reusing the key for changed arguments is refused before approval. A preview needs no key. max length 255
Body
JSON, required.
formatrequired
One of:csv,xlsxcontentrequired
CSV text or base64-encoded XLSX workbook. max length 10000000mapping
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables/<id>/import" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "format": "csv", "content": "string", "mapping": {} }'prudai leo tables importFilter, sort, aggregate and group register records in SQL
POST /v1/tables/{id}/query
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. The result identifies the applied filters and matching count; next_cursor continues the same query.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:read - Approval:
none, no extra step.
Parameters
idrequired
Body
JSON, required.
filtersfilters[].fieldrequired
max length 100filters[].oprequired
One of:eq,neq,lt,lte,gt,gte,between,in,contains,is_emptyfilters[].valuesortsort[].fieldrequired
max length 100sort[].direction
One of:asc,desclimit
min 1 · max 1000cursor
max length 10000include_deletedgroup_byaggregatesaggregates[].oprequired
One of:count,sum,avg,min,max,medianaggregates[].field
max length 100aggregates[].as
max length 100
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables/<id>/query" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "filters": [ { "field": "string", "op": "eq", "value": "string" } ], "sort": [ { "field": "string", "direction": "asc" } ], "limit": 1, "cursor": "string", "include_deleted": false, "group_by": [ "string" ], "aggregates": [ { "op": "count", "field": "string", "as": "string" } ] }'prudai leo tables queryFilter, sort and paginate register records
GET /v1/tables/{id}/records
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. The result identifies the applied filters and matching count; next_cursor continues the same query.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:read - Approval:
none, no extra step.
Parameters
idrequiredinclude_deleted
One of:true,falselimit
min 1 · max 1000cursor
max length 10000filters
JSON array of TableFilter objects. max length 20000sort
JSON array of TableSort objects. max length 20000
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s "https://api.prudai.com/v1/tables/<id>/records" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo tables-records listCreate one register record
POST /v1/tables/{id}/records
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409. Execution requires Idempotency-Key; exact request/grant retries return the stored result without running the write again.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Idempotency: send
Idempotency-Key; the same key with the same body does not run the action twice.
Parameters
idrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIdempotency-Keyrequired
Required for execution; exact retries replay the stored result. Reusing the key for changed arguments is refused before approval. A preview needs no key. max length 255
Body
JSON, required.
datarequiredprovenance
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
201 | Created. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables/<id>/records" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "data": {}, "provenance": {} }'prudai leo tables-records createRead one register record
GET /v1/tables/{id}/records/{rid}
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:read - Approval:
none, no extra step.
Parameters
idrequiredridrequiredinclude_deleted
One of:true,false
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s "https://api.prudai.com/v1/tables/<id>/records/<rid>" \ -H "Authorization: Bearer $PRUDAI_TOKEN"prudai leo tables-records getMerge record values with optimistic concurrency
PATCH /v1/tables/{id}/records/{rid}
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Concurrent changes: send
If-Matchwith the version you read.
Parameters
idrequiredridrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, required.
datarequiredprovenanceversion
min 1
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X PATCH "https://api.prudai.com/v1/tables/<id>/records/<rid>" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "data": {}, "provenance": {}, "version": 1 }'prudai leo tables-records updateSoft-delete a register record
DELETE /v1/tables/{id}/records/{rid}
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:delete - Approval:
review, a second person or role approves. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Concurrent changes: send
If-Matchwith the version you read. - Deleting is soft; see Conventions.
Parameters
idrequiredridrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optional.
version
min 1
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X DELETE "https://api.prudai.com/v1/tables/<id>/records/<rid>" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "version": 1 }'prudai leo tables-records deleteRestore a register record
POST /v1/tables/{id}/records/{rid}/restore
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Concurrent changes: send
If-Matchwith the version you read.
Parameters
idrequiredridrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optional.
version
min 1
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables/<id>/records/<rid>/restore" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "version": 1 }'prudai leo tables-records restoreCreate register records in one approved batch
POST /v1/tables/{id}/records/bulk
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409. Execution requires Idempotency-Key; exact request/grant retries return the stored result without running the write again.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Idempotency: send
Idempotency-Key; the same key with the same body does not run the action twice.
Parameters
idrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIdempotency-Keyrequired
Required for execution; exact retries replay the stored result. Reusing the key for changed arguments is refused before approval. A preview needs no key. max length 255
Body
JSON, required.
recordsrequiredrecords[].datarequiredrecords[].provenance
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
201 | Created. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables/<id>/records/bulk" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "records": [ { "data": {}, "provenance": {} } ] }'prudai leo tables-records bulkRestore a register table (Owner or Admin)
POST /v1/tables/{id}/restore
Same organisation only; another organisation’s id returns 404. Every response uses the standard six-key envelope. Record writes require a writing role; schema changes and table restore require Owner or Admin. Service keys require an active, person-bound creator. dryRun=true returns a preview without persisting records, schema or indexes. Mutations of existing rows require If-Match or version; stale versions return 409.
- State: coming soon, not in production yet.
- Scope:
prudai:tables:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Concurrent changes: send
If-Matchwith the version you read.
Parameters
idrequireddryRun
Validate and preview with no persistent changes. One of:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optional.
version
min 1
Responses
| Status | Meaning |
|---|---|
200 | Result or read-only preview. |
202 | Waiting for the existing central human approval; repeat the exact request with x-prudai-approval after approval. |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Register or record does not exist in this organisation. |
409 | Stale version or unconvertible field values; existing data is preserved. |
422 | Invalid schema, query, mapping or missing version. |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
curl -s -X POST "https://api.prudai.com/v1/tables/<id>/restore" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "version": 1 }'prudai leo tables restore