curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/files/{file_id}/outputs/{output_id} \
--header 'X-API-Key: <api-key>'{
"created_at": "2023-11-07T05:31:56Z",
"download_url": "<string>",
"download_url_expires_at": "2023-11-07T05:31:56Z",
"generation": 123,
"kind": "opensearch_doc",
"output_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"path": "<string>",
"preview_url": "<string>"
}{
"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_file_output
Return a live derived-file output plus short-lived download URLs. Cost class: fast.
Only derived_file outputs live as objects in the workspace store.
Search-index and knowledge-graph outputs carry opaque keys and cannot be
fetched this way.
curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/files/{file_id}/outputs/{output_id} \
--header 'X-API-Key: <api-key>'{
"created_at": "2023-11-07T05:31:56Z",
"download_url": "<string>",
"download_url_expires_at": "2023-11-07T05:31:56Z",
"generation": 123,
"kind": "opensearch_doc",
"output_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"path": "<string>",
"preview_url": "<string>"
}{
"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
A live derived_file output plus short-lived presigned URLs for its bytes.
Search-index and knowledge-graph outputs are not downloadable this way —
their path is an opaque index key, not an object in the workspace store.
Time-limited presigned GET URL that saves the derivative's bytes to disk.
When the presigned URLs stop being valid.
The file version this output was produced from.
Where a derivation landed, for the deletion cascade.
opensearch_doc, kg_document, derived_file Time-limited presigned GET URL that a browser renders inline.