Sign in

v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB
Service Agent

Upload a file

Uploads a file and returns the details of the uploaded file.

post/service_agents/files

Response

The details of the uploaded file.

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"
}