Admin Files

Upload Files

post

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Body

multipart/form-data

uploader_usernamestringRequired

metadatastringRequired

filesstring[]Required

Responses

200

Successful Response

application/json

filenamestring · max: 255Required

sourcestring · max: 255Required

descriptionany ofOptional

string · max: 512Optional

or

nullOptional

storage_pathstring · max: 512Required

uploader_usernamestring · max: 255Required

access_levelany ofOptionalDefault: public

string · max: 50Optional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

organization_idintegerRequired

active_statusany ofOptionalDefault: active

string · max: 50Optional

or

nullOptional

422

Validation Error

application/json

post

/api/v1/admin/files/upload

HTTPcURLJavaScriptPython

POST /api/v1/admin/files/upload HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 63

{
  "uploader_username": "text",
  "metadata": "text",
  "files": [
    "text"
  ]
}

[
  {
    "filename": "text",
    "source": "text",
    "description": "text",
    "storage_path": "text",
    "uploader_username": "text",
    "access_level": "public",
    "tags": [
      "text"
    ],
    "organization_id": 1,
    "active_status": "active"
  }
]

List Admin Files

get

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Query parameters

role_idany ofOptional

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

filenamestring · max: 255Required

sourcestring · max: 255Required

descriptionany ofOptional

string · max: 512Optional

or

nullOptional

storage_pathstring · max: 512Required

uploader_usernamestring · max: 255Required

access_levelany ofOptionalDefault: public

string · max: 50Optional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

organization_idintegerRequired

active_statusany ofOptionalDefault: active

string · max: 50Optional

or

nullOptional

file_idintegerRequired

uploaded_atstring · date-timeRequired

422

Validation Error

application/json

get

/api/v1/admin/files

HTTPcURLJavaScriptPython

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",
    "file_id": 1,
    "uploaded_at": "2026-04-01T13:07:08.102Z"
  }
]

Get Admin File

get

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

file_idintegerRequired

Responses

200

Successful Response

application/json

filenamestring · max: 255Required

sourcestring · max: 255Required

descriptionany ofOptional

string · max: 512Optional

or

nullOptional

storage_pathstring · max: 512Required

uploader_usernamestring · max: 255Required

access_levelany ofOptionalDefault: public

string · max: 50Optional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

organization_idintegerRequired

active_statusany ofOptionalDefault: active

string · max: 50Optional

or

nullOptional

file_idintegerRequired

uploaded_atstring · date-timeRequired

422

Validation Error

application/json

get

/api/v1/admin/files/{file_id}

HTTPcURLJavaScriptPython

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",
  "file_id": 1,
  "uploaded_at": "2026-04-01T13:07:08.102Z"
}

Delete Admin File

delete

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

file_idintegerRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

delete

/api/v1/admin/files/{file_id}

HTTPcURLJavaScriptPython

DELETE /api/v1/admin/files/{file_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update Admin File

patch

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

file_idintegerRequired

Body

application/json

filenameany ofOptional

stringOptional

or

nullOptional

sourceany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

uploaded_atany ofOptional

string · date-timeOptional

or

nullOptional

storage_pathany ofOptional

stringOptional

or

nullOptional

uploader_usernameany ofOptional

stringOptional

or

nullOptional

access_levelany ofOptional

stringOptional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

organization_idany ofOptional

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

filenamestring · max: 255Required

sourcestring · max: 255Required

descriptionany ofOptional

string · max: 512Optional

or

nullOptional

storage_pathstring · max: 512Required

uploader_usernamestring · max: 255Required

access_levelany ofOptionalDefault: public

string · max: 50Optional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

organization_idintegerRequired

active_statusany ofOptionalDefault: active

string · max: 50Optional

or

nullOptional

file_idintegerRequired

uploaded_atstring · date-timeRequired

422

Validation Error

application/json

patch

/api/v1/admin/files/{file_id}

HTTPcURLJavaScriptPython

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-04-01T13:07:08.102Z",
  "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",
  "file_id": 1,
  "uploaded_at": "2026-04-01T13:07:08.102Z"
}

Download Admin File

get

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Path parameters

file_idintegerRequired

Responses

200

Successful Response

No content

422

Validation Error

application/json

get

/api/v1/admin/files/{file_id}/download

HTTPcURLJavaScriptPython

GET /api/v1/admin/files/{file_id}/download HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Sync Admin Files

post

Authorizations

Bearer Token

AuthorizationstringRequired

Enter your JWT token (without 'Bearer ' prefix)

Body

application/x-www-form-urlencoded

directory_pathstringRequired

uploader_usernamestringRequired

organization_idintegerOptionalDefault: 1

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post

/api/v1/admin/files/sync_files

HTTPcURLJavaScriptPython

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