Telnyx

import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: 'My API Key', }); const response = await client.documents.uploadJson({ url: 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf', }); console.log(response.data);

{ "data": { "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58", "record_type": "document", "created_at": "2018-02-02T22:25:27.521Z", "updated_at": "2018-02-02T22:25:27.521Z", "content_type": "application/pdf", "size": { "unit": "bytes", "amount": 123456 }, "status": "pending", "sha256": "08a96c641c3a74e44eb59afb61a24f2cb9f4d7188748e76ba4bb5edfa3cb7d1c", "filename": "test-document.pdf", "customer_reference": "MY REF 001", "av_scan_status": "scanned" } }

Authorizations

Authorization

string

header

required

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

Body

application/json

Option 1
Option 2

url

string

required

If the file is already hosted publicly, you can provide a URL and have the documents service fetch it for you.

Example:

"https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"

filename

string

The filename of the document.

Example:

"test-document.pdf"

customer_reference

string

Optional reference string for customer tracking.

Example:

"MY REF 001"

Response

Successful response

data

object

Show child attributes

data.id

string<uuid>

Identifies the resource.

Example:

"6a09cdc3-8948-47f0-aa62-74ac943d6c58"

data.record_type

string

Identifies the type of the resource. Identifies the type of the resource.

Example:

"document"

data.created_at

string

ISO 8601 formatted date-time indicating when the resource was created.

Example:

"2018-02-02T22:25:27.521Z"

data.updated_at

string

ISO 8601 formatted date-time indicating when the resource was updated.

Example:

"2018-02-02T22:25:27.521Z"

data.content_type

string

The document's content_type.

Example:

"application/pdf"

data.size

object

Indicates the document's filesize

Show child attributes

data.size.unit

string

Identifies the unit

Example:

"bytes"

data.size.amount

integer

The number of bytes

Example:

123456

data.status

enum<string>

Indicates the current document reviewing status

Available options:

pending,

verified,

denied

Example:

"pending"

data.sha256

string

The document's SHA256 hash provided for optional verification purposes.

Example:

"08a96c641c3a74e44eb59afb61a24f2cb9f4d7188748e76ba4bb5edfa3cb7d1c"

data.filename

string

The filename of the document.

Example:

"test-document.pdf"

data.customer_reference

string

Optional reference string for customer tracking.

Example:

"MY REF 001"

data.av_scan_status

enum<string>

The antivirus scan status of the document.

Available options:

scanned,

infected,

pending_scan,

not_scanned

Example:

"scanned"

OAuth Discovery

IP Addresses

IP Ranges

SIM Cards

Addresses

Advanced Number Orders

Assistants

Audio

Chat

Clusters

Conversations

Embeddings

Fine Tuning

Integrations

MCP Servers

Audit Logs

Authentication Providers

Phone Number Search

Billing

Billing Groups

Brands

SIM Card Actions

Bundles

User Bundles

Call Control Applications

Debugging

Call Commands

Call Information

Campaign

Voice Channels

API Reference

Phone Number Orders

Conference Commands

Connections

Country Coverage

Credential Connections

Call Recordings

Customer Service Record

Detail Records

Dialogflow Integration

Documents

Dynamic Emergency Addresses

Dynamic Emergency Endpoints

Enum

External Connections

Programmable Fax Applications

Programmable Fax Commands

FQDN Connections

FQDNs

Global IPs

Inexplicit Number Orders

Integration Secrets

Inventory Level

IP Connections

IPs

Reports

MDR Detailed Reports

Speech to Text Batch Reports

CDR Reports

MDR Usage Reports

Telco Data Usage Reports

Speech to text Usage Reports

CDR Usage Reports

Managed Accounts

Media Storage API

Messages

RCS messaging

Messaging Hosted Number

Number Configurations

Advanced OptIn/OptOut

Messaging Profiles

Messaging Tollfree Verification

Messaging URL Domains

Mobile Network Operators

Push Credentials

Coverage

Networks

Notifications

Phone Number Block Orders

Number Lookup