Nifty Developer API

Upload Files

POST /api/v1.0/files

Bearer

This endpoint uploads multiples files.

Query parameters

project_id string Required

Project ID
task_id string Required

Task ID
doc_id string Required

Document ID
folder_id string

Folder ID
folder_stack array[string]

Folder stack

multipart/form-data

Body Required

List of files

files array[string(binary)]

It contains list of files path from local desktop to upload.

Responses

• 201

The resource created successfully
Hide response attributes Show response attributes object
- message string
  
  Success message
- files array[object] Required
  
  List of Label records
  
  Hide files attributes Show files attributes
  
  id string Required
  
  name string Required
  
  size number Required
  
  url string Required
  
  download string Required
  
  thumbnail string Required
  
  uploader string Required
  
  comments number Required
  
  Number of comments
  
  created_at string(date-time) Required
  
  googleId string Required
  
  googleType string Required
  
  processed boolean Required
  
  task string Required
  
  Task
  
  project_id string Required
  
  Project ID
  
  message string Required
  
  Message
  
  labels array[string] Required
  
  List of labels
  
  folder string Required
  
  folder
  
  folder_stack array[string] Required
  
  Folder path stack
  
  document string Required
  
  Document
  
  annotations_task_id string Required
  
  Annotation Task ID
• 401

The client request has not been completed because it lacks valid authentication credentials for the requested resource.
• 403

The client does not have access rights to the content.
• 405

The request method is known by the server but is not supported by the target resource.

POST /api/v1.0/files

curl \
 -X POST https://openapi.niftypm.com/api/v1.0/files?project_id=string&task_id=string&doc_id=string \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: multipart/form-data" \
 -F "files[]=@file"

Request example

{
  "files": [
    "@file"
  ]
}

Response examples (201)

{
  "message": "string",
  "files": [
    {
      "id": "string",
      "name": "string",
      "size": 42.0,
      "url": "string",
      "download": "string",
      "thumbnail": "string",
      "uploader": "string",
      "comments": 42.0,
      "created_at": "2023-05-04T09:42:00+00:00",
      "googleId": "string",
      "googleType": "string",
      "processed": true,
      "task": "string",
      "project_id": "string",
      "message": "string",
      "labels": [
        "string"
      ],
      "folder": "string",
      "folder_stack": [
        "string"
      ],
      "document": "string",
      "annotations_task_id": "string"
    }
  ]
}