curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/stats \
--header 'X-API-Key: <api-key>'{
"bytes_total": 123,
"files_by_ingestion_status": {},
"files_expiring_within_7d": 123,
"files_total": 123,
"index_documents": 123,
"kg_edges": 123,
"kg_nodes": 123,
"last_ingestion_at": "2023-11-07T05:31:56Z",
"last_reconciliation_at": "2023-11-07T05:31:56Z",
"next_expiry_at": "2023-11-07T05:31:56Z",
"pages_ingested": 123
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}get_workspace_stats
Compute workspace content statistics. Cost class: fast.
Returns file counts, byte totals, ingestion timestamps, and expiry
information — enough for a caller to determine whether the workspace needs
ingestion or a re-ingest without paging through list_files.
pages_ingested, index_documents, kg_nodes, and kg_edges are
zero today and will be populated once the ingestion pipeline, OpenSearch
index, and knowledge graph service are wired to this surface.
curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/stats \
--header 'X-API-Key: <api-key>'{
"bytes_total": 123,
"files_by_ingestion_status": {},
"files_expiring_within_7d": 123,
"files_total": 123,
"index_documents": 123,
"kg_edges": 123,
"kg_nodes": 123,
"last_ingestion_at": "2023-11-07T05:31:56Z",
"last_reconciliation_at": "2023-11-07T05:31:56Z",
"next_expiry_at": "2023-11-07T05:31:56Z",
"pages_ingested": 123
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}Authorizations
Path Parameters
Workspace identifier.
Response
Successful Response
Per-workspace content summary.
files_by_ingestion_status is the completeness instrument: a caller does
not need to page through list_files to know whether anything is stale.
stale > 0 means observed and ingested hashes diverged — call
POST .../ingestions with stale_only=true to catch up. expired > 0 means derived representations were dropped by retention; a re-ingest is
needed to make those files searchable again.
Show child attributes
Show child attributes
Earliest artifact expires_at; null when nothing expires.