Audio

Audio file management for call flows

Upload audio file

post

Upload and process audio file for use in call flows.

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Body

multipart/form-data

filestring · binaryRequired

titlestringOptional

descriptionstringOptional

usageTypestring · enumOptionalPossible values:

tagsstring[]Optional

Responses

201

Audio uploaded

application/json

400

Invalid file or data

401

Unauthorized

post

/audio-management/upload

HTTPcURLJavaScriptPython

POST /api/audio-management/upload HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 91

{
  "file": "binary",
  "title": "text",
  "description": "text",
  "usageType": "welcome",
  "tags": [
    "text"
  ]
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "usageType": "welcome",
  "tags": [
    "text"
  ],
  "durationSeconds": 1,
  "sampleRate": 1,
  "channels": 1,
  "bitDepth": 1,
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "originalFileName": "text",
  "createdAt": "2026-02-16T20:42:52.023Z",
  "updatedAt": "2026-02-16T20:42:52.023Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  }
}

List audio files

get

Get paginated list of audio files. Searchable: title, description, tags.

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Query parameters

pageintegerOptionalDefault: 1

limitinteger · max: 100OptionalDefault: 20

searchstringOptional

sortBystring · enumOptionalPossible values:

sortOrderstring · enumOptionalDefault: descPossible values:

usageTypestring · enumOptionalPossible values:

Responses

200

Paginated list of audio files

application/json

401

Unauthorized

get

/audio-management/audios

HTTPcURLJavaScriptPython

GET /api/audio-management/audios HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "description": "text",
      "usageType": "welcome",
      "tags": [
        "text"
      ],
      "durationSeconds": 1,
      "sampleRate": 1,
      "channels": 1,
      "bitDepth": 1,
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "originalFileName": "text",
      "createdAt": "2026-02-16T20:42:52.023Z",
      "updatedAt": "2026-02-16T20:42:52.023Z",
      "file": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "contentType": "text",
        "fileSize": 1,
        "checksum": "text"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}

Stream audio file

get

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Responses

200

Audio file stream

audio/*

Responsestring · binary

401

Unauthorized

404

Audio not found

get

/audio-management/audio/{id}

HTTPcURLJavaScriptPython

GET /api/audio-management/audio/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Update audio metadata

put

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Body

application/json

titlestringOptional

descriptionstringOptional

usageTypestring · enumOptionalPossible values:

tagsstring[]Optional

Responses

200

Audio updated

application/json

401

Unauthorized

404

Audio not found

put

/audio-management/audio/{id}

HTTPcURLJavaScriptPython

PUT /api/audio-management/audio/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "title": "text",
  "description": "text",
  "usageType": "welcome",
  "tags": [
    "text"
  ]
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "usageType": "welcome",
  "tags": [
    "text"
  ],
  "durationSeconds": 1,
  "sampleRate": 1,
  "channels": 1,
  "bitDepth": 1,
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "originalFileName": "text",
  "createdAt": "2026-02-16T20:42:52.023Z",
  "updatedAt": "2026-02-16T20:42:52.023Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  }
}

Delete audio file

delete

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Responses

200

Audio deleted

application/json

401

Unauthorized

404

Audio not found

delete

/audio-management/audio/{id}

HTTPcURLJavaScriptPython

DELETE /api/audio-management/audio/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text"
}

Get audio metadata

get

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Responses

200

Audio metadata

application/json

401

Unauthorized

404

Audio not found

get

/audio-management/audio/{id}/metadata

HTTPcURLJavaScriptPython

GET /api/audio-management/audio/{id}/metadata HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "usageType": "welcome",
  "tags": [
    "text"
  ],
  "durationSeconds": 1,
  "sampleRate": 1,
  "channels": 1,
  "bitDepth": 1,
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "originalFileName": "text",
  "createdAt": "2026-02-16T20:42:52.023Z",
  "updatedAt": "2026-02-16T20:42:52.023Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  }
}

Get audio with relations

get

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Responses

200

Audio with relations

application/json

401

Unauthorized

404

Audio not found

get

/audio-management/audio/{id}/details

HTTPcURLJavaScriptPython

GET /api/audio-management/audio/{id}/details HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "usageType": "welcome",
  "tags": [
    "text"
  ],
  "durationSeconds": 1,
  "sampleRate": 1,
  "channels": 1,
  "bitDepth": 1,
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "originalFileName": "text",
  "createdAt": "2026-02-16T20:42:52.023Z",
  "updatedAt": "2026-02-16T20:42:52.023Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  },
  "organization": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "slug": "text"
  }
}

Get playback URL

get

Generate temporary signed URL for audio playback.

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Query parameters

expiresIninteger · min: 1 · max: 86400Optional

URL expiration in seconds

Default: 3600

Responses

200

Playback URL generated

application/json

400

Invalid expiresIn

401

Unauthorized

404

Audio not found

get

/audio-management/audio/{id}/playback-url

HTTPcURLJavaScriptPython

GET /api/audio-management/audio/{id}/playback-url HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "playbackUrl": "text",
  "expiresIn": 1,
  "expiresAt": "2026-02-16T20:42:52.023Z"
}

Get audio by usage type

get

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

usageTypestring · enumRequiredPossible values:

Responses

200

List of audio files

application/json

401

Unauthorized

get

/audio-management/audios/usage/{usageType}

HTTPcURLJavaScriptPython

GET /api/audio-management/audios/usage/{usageType} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "description": "text",
    "usageType": "welcome",
    "tags": [
      "text"
    ],
    "durationSeconds": 1,
    "sampleRate": 1,
    "channels": 1,
    "bitDepth": 1,
    "organizationId": "123e4567-e89b-12d3-a456-426614174000",
    "originalFileName": "text",
    "createdAt": "2026-02-16T20:42:52.023Z",
    "updatedAt": "2026-02-16T20:42:52.023Z",
    "file": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "contentType": "text",
      "fileSize": 1,
      "checksum": "text"
    }
  }
]