Sign in

v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB
Storage

Upload a file and create a call with it

Creates a temporary file and initiates a call with the temporary file.

post/storage_files

Response

The created call details.

idstring uuid

The unique identifier of the file. Returned from the POST /storage_files or GET /storage_files response.

customer_idstring uuid

The unique identifier of the customer who owns this file. Returned from the GET /customers response.

owner_typestring

Type of the resource owner (e.g., agent).

owner_idstring uuid

The unique identifier of the resource that owns this file (e.g., an agent or a call). Returned from the corresponding owner resource endpoint.

reference_type'' | 'normal' | 'recording'

The reference type of the file.

reference_idstring uuid

The unique identifier of the referenced resource. Returned from the corresponding resource endpoint.

type'' | 'rag' | 'talk' | 'recording'

The type/category of the file. Indicates the purpose of the uploaded file.

namestring

The name of the file.

detailstring

The details of the file.

filenamestring

The filename of the file.

filesizeinteger

The size of the file in bytes.

uri_downloadstring

The URI for downloading the file.

tm_download_expirestring date-time

Timestamp when the download link expires.

tm_createstring date-time

The creation timestamp.

tm_updatestring date-time

The last update timestamp.

tm_deletestring date-time

The deletion timestamp.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "owner_type": "agent",
  "owner_id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
  "reference_type": "recording",
  "reference_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "rag",
  "name": "meeting-recording.wav",
  "detail": "Recording of the sales meeting",
  "filename": "550e8400-e29b-41d4-a716-446655440000.wav",
  "filesize": 5242880,
  "uri_download": "https://storage.voipbin.net/files/550e8400-e29b-41d4-a716-446655440000.wav",
  "tm_download_expire": "2026-02-15T09:30:00.000000Z",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-16T14:20:00.000000Z",
  "tm_delete": "2026-01-17T18:45:00.000000Z"
}