Admin Files
Enter your JWT token (without 'Bearer ' prefix)
Successful Response
publicactiveuploadedValidation Error
POST /api/v1/admin/files/upload HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 65
{
"uploader_username": "text",
"metadata": "text",
"files": [
"binary"
]
}[
{
"filename": "text",
"source": "text",
"description": "text",
"storage_path": "text",
"uploader_username": "text",
"access_level": "public",
"tags": [
"text"
],
"organization_id": 1,
"active_status": "active",
"processing_status": "uploaded",
"stage": "text",
"failure_reason": "text"
}
]Enter your JWT token (without 'Bearer ' prefix)
Successful Response
publicactiveuploadedValidation Error
GET /api/v1/admin/files HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"filename": "text",
"source": "text",
"description": "text",
"storage_path": "text",
"uploader_username": "text",
"access_level": "public",
"tags": [
"text"
],
"organization_id": 1,
"active_status": "active",
"processing_status": "uploaded",
"stage": "text",
"failure_reason": "text",
"file_id": 1,
"uploaded_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"profile": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
]Enter your JWT token (without 'Bearer ' prefix)
Successful Response
publicactiveuploadedValidation Error
GET /api/v1/admin/files/{file_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"filename": "text",
"source": "text",
"description": "text",
"storage_path": "text",
"uploader_username": "text",
"access_level": "public",
"tags": [
"text"
],
"organization_id": 1,
"active_status": "active",
"processing_status": "uploaded",
"stage": "text",
"failure_reason": "text",
"file_id": 1,
"uploaded_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"profile": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}Enter your JWT token (without 'Bearer ' prefix)
Successful Response
Validation Error
DELETE /api/v1/admin/files/{file_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Enter your JWT token (without 'Bearer ' prefix)
Successful Response
publicactiveuploadedValidation Error
PATCH /api/v1/admin/files/{file_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 204
{
"filename": "text",
"source": "text",
"description": "text",
"uploaded_at": "2026-01-01T00:00:00.000Z",
"storage_path": "text",
"uploader_username": "text",
"access_level": "text",
"tags": [
"text"
],
"organization_id": 1
}{
"filename": "text",
"source": "text",
"description": "text",
"storage_path": "text",
"uploader_username": "text",
"access_level": "public",
"tags": [
"text"
],
"organization_id": 1,
"active_status": "active",
"processing_status": "uploaded",
"stage": "text",
"failure_reason": "text",
"file_id": 1,
"uploaded_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"profile": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}Re-run ingestion for an admin file stuck in 'failed' status (NCP-3810).
force=true also accepts 'completed' files (re-profile + re-index).
Enter your JWT token (without 'Bearer ' prefix)
falseSuccessful Response
publicactiveuploadedValidation Error
POST /api/v1/admin/files/{file_id}/retry HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"filename": "text",
"source": "text",
"description": "text",
"storage_path": "text",
"uploader_username": "text",
"access_level": "public",
"tags": [
"text"
],
"organization_id": 1,
"active_status": "active",
"processing_status": "uploaded",
"stage": "text",
"failure_reason": "text",
"file_id": 1,
"uploaded_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"profile": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}Enter your JWT token (without 'Bearer ' prefix)
Successful Response
No content
Validation Error
GET /api/v1/admin/files/{file_id}/download HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Enter your JWT token (without 'Bearer ' prefix)
1Successful Response
Validation Error
POST /api/v1/admin/files/sync_files HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 72
"directory_path='text'&uploader_username='text'&organization_id=1"No content
Last updated
