Prudai Developer API: registers
De operaties van dit onderdeel (Registers).
Basis-URL https://api.prudai.com/v1. Inloggen staat in Inloggen, scopes in Scopes en rechten, fouten in Fouten. Overzicht.
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:read - Goedkeuring:
none, geen extra stap.
Parameters
include_deleted
Een van:true,falselimit
min. 1 · max. 1000cursor
max. lengte 10000knowledge_base_id
max. lengte 100
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Idempotentie: stuur
Idempotency-Keymee; dezelfde sleutel met dezelfde body voert de actie niet twee keer uit.
Parameters
dryRun
Validate and preview with no persistent changes. Een van:true,falseIdempotency-Keyverplicht
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. lengte 255
Body
JSON, verplicht.
nameverplicht
max. lengte 200description
max. lengte 10000knowledge_base_id
max. lengte 100 · kannullzijnschemaverplichtschema[].keyverplicht
patroon^[a-zA-Z][a-zA-Z0-9_]{0,62}$schema[].labelverplicht
max. lengte 200schema[].typeverplicht
Een van:text,number,amount,percentage,date,boolean,choice,multichoice,party,linkschema[].optionsschema[].required
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:read - Goedkeuring:
none, geen extra stap.
Parameters
idverplichtinclude_deleted
Een van:true,false
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Gelijktijdig wijzigen: stuur
If-Matchmee met de versie die je las.
Parameters
idverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, verplicht.
name
max. lengte 200description
max. lengte 10000knowledge_base_id
max. lengte 100 · kannullzijnschemaschema[].keyverplicht
patroon^[a-zA-Z][a-zA-Z0-9_]{0,62}$schema[].labelverplicht
max. lengte 200schema[].typeverplicht
Een van:text,number,amount,percentage,date,boolean,choice,multichoice,party,linkschema[].optionsschema[].requiredversion
min. 1
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:delete - Goedkeuring:
review, een tweede persoon of rol keurt goed. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Gelijktijdig wijzigen: stuur
If-Matchmee met de versie die je las. - Verwijderen is zacht; zie Conventies.
Parameters
idverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optioneel.
version
min. 1
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:read - Goedkeuring:
none, geen extra stap.
Parameters
idverplichtinclude_deleted
Een van:true,falsefilters
JSON array of TableFilter objects. max. lengte 20000sort
JSON array of TableSort objects. max. lengte 20000format
Een van:csv,xlsx,json· standaard:"csv"
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Idempotentie: stuur
Idempotency-Keymee; dezelfde sleutel met dezelfde body voert de actie niet twee keer uit.
Parameters
idverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIdempotency-Keyverplicht
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. lengte 255
Body
JSON, verplicht.
formatverplicht
Een van:csv,xlsxcontentverplicht
CSV text or base64-encoded XLSX workbook. max. lengte 10000000mapping
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:read - Goedkeuring:
none, geen extra stap.
Parameters
idverplicht
Body
JSON, verplicht.
filtersfilters[].fieldverplicht
max. lengte 100filters[].opverplicht
Een van:eq,neq,lt,lte,gt,gte,between,in,contains,is_emptyfilters[].valuesortsort[].fieldverplicht
max. lengte 100sort[].direction
Een van:asc,desclimit
min. 1 · max. 1000cursor
max. lengte 10000include_deletedgroup_byaggregatesaggregates[].opverplicht
Een van:count,sum,avg,min,max,medianaggregates[].field
max. lengte 100aggregates[].as
max. lengte 100
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:read - Goedkeuring:
none, geen extra stap.
Parameters
idverplichtinclude_deleted
Een van:true,falselimit
min. 1 · max. 1000cursor
max. lengte 10000filters
JSON array of TableFilter objects. max. lengte 20000sort
JSON array of TableSort objects. max. lengte 20000
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Idempotentie: stuur
Idempotency-Keymee; dezelfde sleutel met dezelfde body voert de actie niet twee keer uit.
Parameters
idverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIdempotency-Keyverplicht
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. lengte 255
Body
JSON, verplicht.
dataverplichtprovenance
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:read - Goedkeuring:
none, geen extra stap.
Parameters
idverplichtridverplichtinclude_deleted
Een van:true,false
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Gelijktijdig wijzigen: stuur
If-Matchmee met de versie die je las.
Parameters
idverplichtridverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, verplicht.
dataverplichtprovenanceversion
min. 1
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:delete - Goedkeuring:
review, een tweede persoon of rol keurt goed. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Gelijktijdig wijzigen: stuur
If-Matchmee met de versie die je las. - Verwijderen is zacht; zie Conventies.
Parameters
idverplichtridverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optioneel.
version
min. 1
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Gelijktijdig wijzigen: stuur
If-Matchmee met de versie die je las.
Parameters
idverplichtridverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optioneel.
version
min. 1
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Idempotentie: stuur
Idempotency-Keymee; dezelfde sleutel met dezelfde body voert de actie niet twee keer uit.
Parameters
idverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIdempotency-Keyverplicht
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. lengte 255
Body
JSON, verplicht.
recordsverplichtrecords[].dataverplichtrecords[].provenance
Antwoorden
| Status | Betekenis |
|---|---|
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.
- Stand: binnenkort, nog niet op productie.
- Scope:
prudai:tables:write - Goedkeuring:
confirm, de gebruiker bevestigt precies deze aanroep. - Dry run:
?dryRun=truelaat zien wat er zou gebeuren en slaat niets op. - Gelijktijdig wijzigen: stuur
If-Matchmee met de versie die je las.
Parameters
idverplichtdryRun
Validate and preview with no persistent changes. Een van:true,falseIf-Match
Current positive version, bare or double-quoted. Required unless body.version is provided.
Body
JSON, optioneel.
version
min. 1
Antwoorden
| Status | Betekenis |
|---|---|
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