Request Presigned File URLs

POST

presigned-file-urls

curl --request POST \
  --url https://api.gonitro.dev/presigned-file-urls \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gonitro.dev/presigned-file-urls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gonitro.dev/presigned-file-urls",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gonitro.dev/presigned-file-urls"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gonitro.dev/presigned-file-urls")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "urls": [
    {
      "uploadURL": "https://storage.example.com/in/abc123/def456?X-Amz-Signature=...",
      "downloadURL": "https://storage.example.com/in/abc123/def456?X-Amz-Signature=...",
      "ID": "https://storage.example.com/in/abc123/def456?X-Amz-Signature=..."
    }
  ]
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#400-bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Request validation failed",
  "instance": "/platform/presigned-file-urls"
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#401-unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Missing or invalid Authorization header",
  "instance": "/platform/presigned-file-urls"
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#422-unprocessable-entity",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The request was well-formed but could not be processed",
  "instance": "/platform/presigned-file-urls"
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#500-internal-server-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred",
  "instance": "/platform/presigned-file-urls"
}

Standard file submission sends your file’s bytes through the request body of an operation call (/conversions, /extractions, /transformations, /generations), which is bounded by the platform’s overall request size limit. The Presigned File URLs endpoint offers an alternative path for larger files: you upload directly to storage yourself, then pass a reference to that upload into the operation instead of the raw bytes.

How it works

Call this endpoint to receive one or more {uploadURL, downloadURL} pairs.
Upload your file’s bytes to uploadURL with an HTTP PUT request.
Submit your operation as normal, but instead of attaching the file’s bytes to the file field, pass a remote file reference:
{"URL": "<downloadURL>", "contentType": "application/pdf"}
using the same multipart encoding (type=application/vnd.gonitro.url+json) documented on the file field of every operation.

A presigned URL pair is valid for 15 minutes and intended for a single operation submission. Don’t cache or reuse a pair across multiple operations — request a fresh pair each time. Once the 15-minute window has passed, both the upload and download URLs stop working; if your workflow needs more time between requesting a pair and submitting the operation, request the pair immediately before you need it rather than in advance.

Multiple files

Pass n to request more than one pair in a single call — useful when an operation (such as Merge) takes multiple input files. Each pair in the response is independent and points at its own storage location.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

integer

default:1

Number of presigned URL pairs to generate, useful when submitting a job with multiple input files.

Required range: 1 <= x <= 25

Response

Presigned URL pairs generated successfully

One or more presigned URL pairs, as requested via the n query parameter.

urls

Presigned URL pair · object[]

required

The generated presigned URL pairs, one per requested file.

Show child attributes

Request Presigned File URLs

curl --request POST \
  --url https://api.gonitro.dev/presigned-file-urls \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gonitro.dev/presigned-file-urls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gonitro.dev/presigned-file-urls",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gonitro.dev/presigned-file-urls"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gonitro.dev/presigned-file-urls")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "urls": [
    {
      "uploadURL": "https://storage.example.com/in/abc123/def456?X-Amz-Signature=...",
      "downloadURL": "https://storage.example.com/in/abc123/def456?X-Amz-Signature=...",
      "ID": "https://storage.example.com/in/abc123/def456?X-Amz-Signature=..."
    }
  ]
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#400-bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Request validation failed",
  "instance": "/platform/presigned-file-urls"
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#401-unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Missing or invalid Authorization header",
  "instance": "/platform/presigned-file-urls"
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#422-unprocessable-entity",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The request was well-formed but could not be processed",
  "instance": "/platform/presigned-file-urls"
}

{
  "type": "https://developers.gonitro.com/docs/build-nitro/errors#500-internal-server-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred",
  "instance": "/platform/presigned-file-urls"
}

Authentication

PDF Services API

Nitro Sign API

Product updates

Request Presigned File URLs

How it works

Multiple files

Authorizations

Query Parameters

Response

​How it works

​Multiple files

Authorizations

Query Parameters

Response

How it works

Multiple files