Get file download URL

GET 
/api/v1/files/:file-id/download_url

Get a signed private URL for downloading files from Needle. The download URL will be valid for a short time therefore you should read the file immediately after receiving the URL.

Request

Path Parameters

file-id stringrequired

File ID

Responses

200

Successful response

application/json

Schema

Schema

result urirequired

URL for downloading the file

Example (from schema)

{
  "result": "string"
}

400

Invalid request

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

401

Unauthorized request

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

403

Forbidden file, user does not have sufficient permissions to access the file

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

404

File not found

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

Loading...