Download Document

curl --request GET \
  --url https://api.agentoffice.dev/v1/documents/{doc_id} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.agentoffice.dev/v1/documents/{doc_id}', 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.agentoffice.dev/v1/documents/{doc_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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.agentoffice.dev/v1/documents/{doc_id}"

	req, _ := http.NewRequest("GET", 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.agentoffice.dev/v1/documents/{doc_id}")

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

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

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

{
  "detail": "Document not found or has expired"
}

{
  "detail": "Access denied to this document"
}

GET

documents

{doc_id}

Download Document

curl --request GET \
  --url https://api.agentoffice.dev/v1/documents/{doc_id} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.agentoffice.dev/v1/documents/{doc_id}', 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.agentoffice.dev/v1/documents/{doc_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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.agentoffice.dev/v1/documents/{doc_id}"

	req, _ := http.NewRequest("GET", 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.agentoffice.dev/v1/documents/{doc_id}")

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

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

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

{
  "detail": "Document not found or has expired"
}

{
  "detail": "Access denied to this document"
}

Download a Document

Retrieve a presigned S3 URL to download your document. The URL is temporary and secure, expiring after the specified duration.

Path Parameters

string

required

The unique identifier of the document to download (UUID)

Query Parameters

integer

Number of seconds until the download URL expires (1-86400). Default is 3600 (1 hour).

Response

string

required

UUID of the document

string

required

Presigned S3 URL for downloading the document

integer

required

Number of seconds until the URL expires

string

required

Original filename of the document

Code Examples

const docId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";

const response = await fetch(
  `https://api.agentoffice.dev/v1/documents/${docId}?expiresIn=3600`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);

const data = await response.json();

// Download the file
const downloadResponse = await fetch(data.downloadUrl);
const blob = await downloadResponse.blob();

// Create download link
const url = window.URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = data.filename;
a.click();

import requests

doc_id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
url = f'https://api.agentoffice.dev/v1/documents/{doc_id}'

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

params = {
    'expiresIn': 3600
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# Download the file
download_response = requests.get(data['downloadUrl'])

# Save to disk
with open(data['filename'], 'wb') as f:
    f.write(download_response.content)

print(f"Downloaded: {data['filename']}")

from agent_office import AgentOffice
import requests
import os

client = AgentOffice(api_key=os.getenv('AGENT_OFFICE_API_KEY'))

doc_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

result = client.documents.download(
    doc_id=doc_id,
    expires_in=3600
)

# Download the file
download_response = requests.get(result.download_url)

# Save to disk
with open(result.filename, 'wb') as f:
    f.write(download_response.content)

print(f"Downloaded: {result.filename}")

import fs from "fs";

const docId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";

const response = await fetch(
  `https://api.agentoffice.dev/v1/documents/${docId}?expiresIn=3600`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);

const data = await response.json();

// Download and save the file
const downloadResponse = await fetch(data.downloadUrl);
const buffer = await downloadResponse.arrayBuffer();

fs.writeFileSync(data.filename, Buffer.from(buffer));
console.log(`Downloaded: ${data.filename}`);

curl -X GET 'https://api.agentoffice.dev/v1/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890?expiresIn=3600' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "docId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "https://s3.amazonaws.com/bucket/document.docx?X-Amz-Algorithm=...",
  "expiresIn": 3600,
  "filename": "report.docx"
}

Complete Workflow Example

Here’s a complete example showing upload, edit, and download:

import { v4 as uuidv4 } from "uuid";

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.agentoffice.dev";

async function processDocument(file) {
  // 1. Upload document
  const formData = new FormData();
  formData.append("file", file);

  const uploadResponse = await fetch(`${BASE_URL}/v1/documents/`, {
    method: "POST",
    headers: { Authorization: `Bearer ${API_KEY}` },
    body: formData,
  });

  const { docId } = await uploadResponse.json();
  console.log("Uploaded document:", docId);

  // 2. Apply edit
  const editResponse = await fetch(`${BASE_URL}/v1/documents/${docId}/edits`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      editUid: uuidv4(),
      editInstructions: "Update all dates to 2024",
    }),
  });

  const editResult = await editResponse.json();
  console.log("Edit applied:", editResult.editApplied);

  // 3. Download edited document
  const downloadResponse = await fetch(`${BASE_URL}/v1/documents/${docId}`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });

  const { downloadUrl, filename } = await downloadResponse.json();

  // Download the file
  const fileResponse = await fetch(downloadUrl);
  const blob = await fileResponse.blob();

  // Trigger browser download
  const url = window.URL.createObjectURL(blob);
  const a = document.createElement("a");
  a.href = url;
  a.download = filename;
  a.click();

  console.log("Downloaded:", filename);
}

import requests
import uuid

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.agentoffice.dev'

def process_document(file_path):
    headers = {'Authorization': f'Bearer {API_KEY}'}

    # 1. Upload document
    with open(file_path, 'rb') as f:
        files = {'file': f}
        upload_response = requests.post(
            f'{BASE_URL}/v1/documents/',
            headers=headers,
            files=files
        )

    doc_id = upload_response.json()['docId']
    print(f'Uploaded document: {doc_id}')

    # 2. Apply edit
    edit_payload = {
        'editUid': str(uuid.uuid4()),
        'editInstructions': 'Update all dates to 2024'
    }

    edit_response = requests.post(
        f'{BASE_URL}/v1/documents/{doc_id}/edits',
        headers={**headers, 'Content-Type': 'application/json'},
        json=edit_payload
    )

    edit_result = edit_response.json()
    print(f"Edit applied: {edit_result['editApplied']}")

    # 3. Download edited document
    download_response = requests.get(
        f'{BASE_URL}/v1/documents/{doc_id}',
        headers=headers
    )

    download_data = download_response.json()
    download_url = download_data['downloadUrl']
    filename = download_data['filename']

    # Download and save file
    file_response = requests.get(download_url)
    with open(f'edited_{filename}', 'wb') as f:
        f.write(file_response.content)

    print(f'Downloaded: edited_{filename}')

# Usage
process_document('document.docx')

Presigned URL Security

The presigned URL allows anyone with the link to download the document. Keep URLs private and don’t share them publicly.

URL Expiration

Presigned URLs expire after the specified duration (default 1 hour)
You can generate a new URL at any time by calling the endpoint again
Expired URLs will return a 403 Forbidden error

Best Practices

Short Expiration Times

Use shorter expiration times (e.g., 300 seconds) for sensitive documents

One-Time Downloads

Generate a new URL for each download to maintain security

Programmatic Downloads

Download files programmatically instead of exposing URLs to end users

Error Responses

{
  "detail": "Document not found or has expired"
}

{
  "detail": "Access denied to this document"
}

Documents are automatically deleted after their TTL expires. Make sure to download important documents before they expire.

Getting Started

API Reference

SDKs

Download Document

Download a Document

Path Parameters

Query Parameters

Response

Code Examples

Example Response

Complete Workflow Example

Presigned URL Security

URL Expiration

Best Practices

Error Responses

​Download a Document

​Path Parameters

​Query Parameters

​Response

​Code Examples

​Example Response

​Complete Workflow Example

​Presigned URL Security

​URL Expiration

​Best Practices

​Error Responses

Download a Document

Path Parameters

Query Parameters

Response

Code Examples

Example Response

Complete Workflow Example

Presigned URL Security

URL Expiration

Best Practices

Error Responses