Criar envio de arquivo

curl --request POST \
  --url https://api.base39.com.br/v2/file_uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "Annual Report 2024.pdf",
  "content_type": "application/pdf",
  "purpose": "company",
  "size_bytes": 1048576,
  "entity_type": "company",
  "entity_id": "cmp_abc123",
  "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "source_url": "https://example.com/certificate.pdf",
  "page_id": "page_abc123",
  "public": false,
  "agent_id": "agt_abc123",
  "agent_version": "2026-02-08-10-00-00"
}
'

import requests

url = "https://api.base39.com.br/v2/file_uploads"

payload = {
    "filename": "Annual Report 2024.pdf",
    "content_type": "application/pdf",
    "purpose": "company",
    "size_bytes": 1048576,
    "entity_type": "company",
    "entity_id": "cmp_abc123",
    "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "source_url": "https://example.com/certificate.pdf",
    "page_id": "page_abc123",
    "public": False,
    "agent_id": "agt_abc123",
    "agent_version": "2026-02-08-10-00-00"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filename: 'Annual Report 2024.pdf',
    content_type: 'application/pdf',
    purpose: 'company',
    size_bytes: 1048576,
    entity_type: 'company',
    entity_id: 'cmp_abc123',
    content_hash: 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
    source_url: 'https://example.com/certificate.pdf',
    page_id: 'page_abc123',
    public: false,
    agent_id: 'agt_abc123',
    agent_version: '2026-02-08-10-00-00'
  })
};

fetch('https://api.base39.com.br/v2/file_uploads', 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.base39.com.br/v2/file_uploads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filename' => 'Annual Report 2024.pdf',
    'content_type' => 'application/pdf',
    'purpose' => 'company',
    'size_bytes' => 1048576,
    'entity_type' => 'company',
    'entity_id' => 'cmp_abc123',
    'content_hash' => 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
    'source_url' => 'https://example.com/certificate.pdf',
    'page_id' => 'page_abc123',
    'public' => false,
    'agent_id' => 'agt_abc123',
    'agent_version' => '2026-02-08-10-00-00'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.base39.com.br/v2/file_uploads"

	payload := strings.NewReader("{\n  \"filename\": \"Annual Report 2024.pdf\",\n  \"content_type\": \"application/pdf\",\n  \"purpose\": \"company\",\n  \"size_bytes\": 1048576,\n  \"entity_type\": \"company\",\n  \"entity_id\": \"cmp_abc123\",\n  \"content_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n  \"source_url\": \"https://example.com/certificate.pdf\",\n  \"page_id\": \"page_abc123\",\n  \"public\": false,\n  \"agent_id\": \"agt_abc123\",\n  \"agent_version\": \"2026-02-08-10-00-00\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.base39.com.br/v2/file_uploads")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filename\": \"Annual Report 2024.pdf\",\n  \"content_type\": \"application/pdf\",\n  \"purpose\": \"company\",\n  \"size_bytes\": 1048576,\n  \"entity_type\": \"company\",\n  \"entity_id\": \"cmp_abc123\",\n  \"content_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n  \"source_url\": \"https://example.com/certificate.pdf\",\n  \"page_id\": \"page_abc123\",\n  \"public\": false,\n  \"agent_id\": \"agt_abc123\",\n  \"agent_version\": \"2026-02-08-10-00-00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.base39.com.br/v2/file_uploads")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filename\": \"Annual Report 2024.pdf\",\n  \"content_type\": \"application/pdf\",\n  \"purpose\": \"company\",\n  \"size_bytes\": 1048576,\n  \"entity_type\": \"company\",\n  \"entity_id\": \"cmp_abc123\",\n  \"content_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n  \"source_url\": \"https://example.com/certificate.pdf\",\n  \"page_id\": \"page_abc123\",\n  \"public\": false,\n  \"agent_id\": \"agt_abc123\",\n  \"agent_version\": \"2026-02-08-10-00-00\"\n}"

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

{
  "object": "page",
  "id": "p_abc123",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T14:45:00.000Z",
  "status": "uploaded",
  "filename": "report.pdf",
  "content_type": "application/pdf",
  "size_bytes": 1048576,
  "metadata": {
    "page_count": 12
  },
  "uploaded_time": "2024-11-14T10:31:23.456Z",
  "expires_at": "2024-11-14T11:30:00.000Z",
  "public": false,
  "classification": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe",
    "document_type": "balance_sheet",
    "confidence": 0.98
  },
  "parse": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe",
    "jobId": "<string>"
  },
  "index": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe"
  },
  "insights": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe",
    "facts": [
      {
        "id": "<string>",
        "entity_indexes": [
          123
        ],
        "statement": "<string>",
        "references": [
          {
            "page_number": 123
          }
        ],
        "method": "verbatim",
        "confidence": 123,
        "source_id": "<string>",
        "entities": [
          {
            "type": "company",
            "name": "<string>",
            "document": "<string>"
          }
        ]
      }
    ],
    "claims": [
      {
        "id": "cl_abc123",
        "statement": "Company revenue increased 15% YoY",
        "confidence": 0.92,
        "supporting_facts": [
          "f_xyz789"
        ],
        "category": "financial"
      }
    ],
    "issues": [
      {
        "id": "iss_abc123",
        "type": "missing_data",
        "description": "Required field \"date\" is missing",
        "severity": "warning",
        "fact_id": "f_xyz789"
      }
    ],
    "checks": [
      {
        "id": "chk_abc123",
        "name": "total_assets_validation",
        "passed": true,
        "message": "Total assets matches sum of components",
        "severity": "info"
      }
    ]
  },
  "createdBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "updatedBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "reused": false,
  "upload_url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=...",
  "upload_headers": {},
  "url": "https://files.base39.cloud/uploads/org_abc/fl_abc123/report.pdf",
  "preview_url": "https://files.base39.cloud/uploads/org_abc/fl_abc123/preview/page-01.png",
  "download_url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=...",
  "page_id": "page_abc123",
  "purpose": "agent",
  "public_url": "https://files.base39.com.br/uploads/org_abc/fl_abc123/report.pdf",
  "resources": [
    {}
  ]
}

POST

file_uploads

Criar envio de arquivo

curl --request POST \
  --url https://api.base39.com.br/v2/file_uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "Annual Report 2024.pdf",
  "content_type": "application/pdf",
  "purpose": "company",
  "size_bytes": 1048576,
  "entity_type": "company",
  "entity_id": "cmp_abc123",
  "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "source_url": "https://example.com/certificate.pdf",
  "page_id": "page_abc123",
  "public": false,
  "agent_id": "agt_abc123",
  "agent_version": "2026-02-08-10-00-00"
}
'

import requests

url = "https://api.base39.com.br/v2/file_uploads"

payload = {
    "filename": "Annual Report 2024.pdf",
    "content_type": "application/pdf",
    "purpose": "company",
    "size_bytes": 1048576,
    "entity_type": "company",
    "entity_id": "cmp_abc123",
    "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "source_url": "https://example.com/certificate.pdf",
    "page_id": "page_abc123",
    "public": False,
    "agent_id": "agt_abc123",
    "agent_version": "2026-02-08-10-00-00"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filename: 'Annual Report 2024.pdf',
    content_type: 'application/pdf',
    purpose: 'company',
    size_bytes: 1048576,
    entity_type: 'company',
    entity_id: 'cmp_abc123',
    content_hash: 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
    source_url: 'https://example.com/certificate.pdf',
    page_id: 'page_abc123',
    public: false,
    agent_id: 'agt_abc123',
    agent_version: '2026-02-08-10-00-00'
  })
};

fetch('https://api.base39.com.br/v2/file_uploads', 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.base39.com.br/v2/file_uploads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filename' => 'Annual Report 2024.pdf',
    'content_type' => 'application/pdf',
    'purpose' => 'company',
    'size_bytes' => 1048576,
    'entity_type' => 'company',
    'entity_id' => 'cmp_abc123',
    'content_hash' => 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
    'source_url' => 'https://example.com/certificate.pdf',
    'page_id' => 'page_abc123',
    'public' => false,
    'agent_id' => 'agt_abc123',
    'agent_version' => '2026-02-08-10-00-00'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.base39.com.br/v2/file_uploads"

	payload := strings.NewReader("{\n  \"filename\": \"Annual Report 2024.pdf\",\n  \"content_type\": \"application/pdf\",\n  \"purpose\": \"company\",\n  \"size_bytes\": 1048576,\n  \"entity_type\": \"company\",\n  \"entity_id\": \"cmp_abc123\",\n  \"content_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n  \"source_url\": \"https://example.com/certificate.pdf\",\n  \"page_id\": \"page_abc123\",\n  \"public\": false,\n  \"agent_id\": \"agt_abc123\",\n  \"agent_version\": \"2026-02-08-10-00-00\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.base39.com.br/v2/file_uploads")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filename\": \"Annual Report 2024.pdf\",\n  \"content_type\": \"application/pdf\",\n  \"purpose\": \"company\",\n  \"size_bytes\": 1048576,\n  \"entity_type\": \"company\",\n  \"entity_id\": \"cmp_abc123\",\n  \"content_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n  \"source_url\": \"https://example.com/certificate.pdf\",\n  \"page_id\": \"page_abc123\",\n  \"public\": false,\n  \"agent_id\": \"agt_abc123\",\n  \"agent_version\": \"2026-02-08-10-00-00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.base39.com.br/v2/file_uploads")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filename\": \"Annual Report 2024.pdf\",\n  \"content_type\": \"application/pdf\",\n  \"purpose\": \"company\",\n  \"size_bytes\": 1048576,\n  \"entity_type\": \"company\",\n  \"entity_id\": \"cmp_abc123\",\n  \"content_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n  \"source_url\": \"https://example.com/certificate.pdf\",\n  \"page_id\": \"page_abc123\",\n  \"public\": false,\n  \"agent_id\": \"agt_abc123\",\n  \"agent_version\": \"2026-02-08-10-00-00\"\n}"

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

{
  "object": "page",
  "id": "p_abc123",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T14:45:00.000Z",
  "status": "uploaded",
  "filename": "report.pdf",
  "content_type": "application/pdf",
  "size_bytes": 1048576,
  "metadata": {
    "page_count": 12
  },
  "uploaded_time": "2024-11-14T10:31:23.456Z",
  "expires_at": "2024-11-14T11:30:00.000Z",
  "public": false,
  "classification": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe",
    "document_type": "balance_sheet",
    "confidence": 0.98
  },
  "parse": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe",
    "jobId": "<string>"
  },
  "index": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe"
  },
  "insights": {
    "status": "completed",
    "started_at": "2024-12-07T11:01:00.000Z",
    "completed_at": "2024-12-07T11:02:30.000Z",
    "error": "Unsupported file type for parsing: arquivo.exe",
    "facts": [
      {
        "id": "<string>",
        "entity_indexes": [
          123
        ],
        "statement": "<string>",
        "references": [
          {
            "page_number": 123
          }
        ],
        "method": "verbatim",
        "confidence": 123,
        "source_id": "<string>",
        "entities": [
          {
            "type": "company",
            "name": "<string>",
            "document": "<string>"
          }
        ]
      }
    ],
    "claims": [
      {
        "id": "cl_abc123",
        "statement": "Company revenue increased 15% YoY",
        "confidence": 0.92,
        "supporting_facts": [
          "f_xyz789"
        ],
        "category": "financial"
      }
    ],
    "issues": [
      {
        "id": "iss_abc123",
        "type": "missing_data",
        "description": "Required field \"date\" is missing",
        "severity": "warning",
        "fact_id": "f_xyz789"
      }
    ],
    "checks": [
      {
        "id": "chk_abc123",
        "name": "total_assets_validation",
        "passed": true,
        "message": "Total assets matches sum of components",
        "severity": "info"
      }
    ]
  },
  "createdBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "updatedBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "reused": false,
  "upload_url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=...",
  "upload_headers": {},
  "url": "https://files.base39.cloud/uploads/org_abc/fl_abc123/report.pdf",
  "preview_url": "https://files.base39.cloud/uploads/org_abc/fl_abc123/preview/page-01.png",
  "download_url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=...",
  "page_id": "page_abc123",
  "purpose": "agent",
  "public_url": "https://files.base39.com.br/uploads/org_abc/fl_abc123/report.pdf",
  "resources": [
    {}
  ]
}

Autorizações

Authorization

string

header

obrigatório

OAuth2 Authorization Code flow

Corpo

application/json

filename

string

obrigatório

Original filename with extension (max 900 bytes)

Exemplo:

"Annual Report 2024.pdf"

content_type

string

obrigatório

MIME content type

Exemplo:

"application/pdf"

purpose

enum<string>

obrigatório

Purpose of the upload

Opções disponíveis:

agent,

knowledge,

skill,

metadata,

dataset,

company,

page,

session,

page_run_output,

export,

whatsapp,

fiscal_document

Exemplo:

"company"

size_bytes

number

File size in bytes (optional, for validation)

Exemplo:

1048576

entity_type

string

Entity type to link this file to (e.g. "company", "person", "lawsuit")

Exemplo:

"company"

entity_id

string

Entity ID to link this file to

Exemplo:

"cmp_abc123"

content_hash

string

SHA-256 hex hash of the file content for deduplication

Exemplo:

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

source_url

string

Source URL (for files downloaded from external sources). Used for deduplication - prevents downloading the same file multiple times

Exemplo:

"https://example.com/certificate.pdf"

page_id

string

Page ID to associate this file with (optional)

Exemplo:

"page_abc123"

public

boolean

Whether this file can be fetched without authentication through its public URL

Exemplo:

false

agent_id

string

Agent ID for agent uploads (required when purpose=agent)

Exemplo:

"agt_abc123"

agent_version

string

Agent version name for agent uploads (required when purpose=agent)

Exemplo:

"2026-02-08-10-00-00"

Resposta

201 - application/json

object

string

obrigatório

Object type

Exemplo:

"page"

string

obrigatório

Unique identifier

Exemplo:

"p_abc123"

createdAt

string<date-time>

obrigatório

Creation timestamp

Exemplo:

"2024-01-15T10:30:00.000Z"

updatedAt

string<date-time>

obrigatório

Last update timestamp

Exemplo:

"2024-01-15T14:45:00.000Z"

status

enum<string>

obrigatório

Upload status

pending: Waiting for client upload
uploaded: Successfully uploaded
failed: Upload failed or expired

Opções disponíveis:

pending,

uploaded,

failed

Exemplo:

"uploaded"

filename

string

obrigatório

Original filename

Exemplo:

"report.pdf"

content_type

string

obrigatório

MIME content type

Exemplo:

"application/pdf"

size_bytes

number | null

obrigatório

File size in bytes (null if not yet uploaded)

Exemplo:

1048576

metadata

object | null

obrigatório

File metadata. PDF page count is stored at metadata.page_count when available.

Exemplo:

{ "page_count": 12 }

uploaded_time

string<date-time> | null

obrigatório

When the file was successfully uploaded (null if pending)

Exemplo:

"2024-11-14T10:31:23.456Z"

expires_at

string

obrigatório

When the upload URL expires (ISO 8601 string for API response)

Exemplo:

"2024-11-14T11:30:00.000Z"

public

boolean

obrigatório

Whether this file can be fetched without authentication through public_url.

Exemplo:

false

classification

object

obrigatório

Document classification stage - determines document type and next stages

Show child attributes

parse

object

obrigatório

Parse stage - converts OCR output to markdown

Show child attributes

index

object

obrigatório

Index stage - vector embedding for semantic search

Show child attributes

insights

object

obrigatório

Insights stage - skill-based analysis generating claims/issues/checks

Show child attributes

createdBy

Created by · object

Principal who created this object

Show child attributes

Exemplo:

{
  "object": "user",
  "id": "u_abc123",
  "apiKeyId": "bsk_abc123"
}

updatedBy

Updated by · object

Principal who last updated this object

Show child attributes

Exemplo:

{
  "object": "user",
  "id": "u_abc123",
  "apiKeyId": "bsk_abc123"
}

reused

boolean

Whether this response reuses an existing file (content-based dedup)

Exemplo:

false

upload_url

string

Presigned S3 upload URL (only present when status is 'pending' and reused is false) Client should PUT file contents to this URL Expires after 1 hour

Exemplo:

"https://s3.amazonaws.com/bucket/key?X-Amz-Signature=..."

upload_headers

object

Extra headers required for uploading to the presigned URL (only present when status is pending).

Show child attributes

url

string

Authenticated files URL (CloudFront signed cookies) Only present when the file has an S3 key

Exemplo:

"https://files.base39.cloud/uploads/org_abc/fl_abc123/report.pdf"

preview_url

string

Authenticated preview URL for the first generated thumbnail page. Only present when a preview image exists.

Exemplo:

"https://files.base39.cloud/uploads/org_abc/fl_abc123/preview/page-01.png"

download_url

string

Presigned S3 download URL. Only returned when explicitly requested via ?fields=downloadUrl and status is 'uploaded'. Expires after 1 hour.

Exemplo:

"https://s3.amazonaws.com/bucket/key?X-Amz-Signature=..."

page_id

string

Page ID associated with this file upload (optional)

Exemplo:

"page_abc123"

purpose

enum<string> | null

Upload purpose

Opções disponíveis:

agent,

knowledge,

skill,

metadata,

dataset,

company,

page,

session,

page_run_output,

export,

whatsapp,

fiscal_document

public_url

string

Direct files URL. Only present when public is true.

Exemplo:

"https://files.base39.com.br/uploads/org_abc/fl_abc123/report.pdf"

resources

object[] | null

Provider-specific file resources attached to this upload.

Entidades

Pesquisa

Empresas

Cadastro

Endereços

Relacionamentos

Consultas

Crédito e finanças

Restrições

Cheques

Protestos

Dívidas com a União

SCR

Processos e falências

Conformidade

Certidões

Reputação

Benefícios sociais

Histórico cadastral

Arquivos

Regras

Monitoramento

Criar envio de arquivo

Autorizações

Corpo

Resposta