Audio

Audio file management for call flows

Upload audio file

post

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audio-management/upload

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 /audio-management/upload HTTP/1.1
Host: api.gomobile.io
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": "2025-12-19T15:48:02.728Z",
  "updatedAt": "2025-12-19T15:48:02.728Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  }
}

List audio files

get

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audio-management/audios

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 /audio-management/audios HTTP/1.1
Host: api.gomobile.io
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": "2025-12-19T15:48:02.728Z",
      "updatedAt": "2025-12-19T15:48:02.728Z",
      "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

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audio-management/audio/{id}

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 /audio-management/audio/{id} HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Update audio metadata

put

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audio-management/audio/{id}

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 /audio-management/audio/{id} HTTP/1.1
Host: api.gomobile.io
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": "2025-12-19T15:48:02.728Z",
  "updatedAt": "2025-12-19T15:48:02.728Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  }
}

Delete audio file

delete

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audio-management/audio/{id}

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 /audio-management/audio/{id} HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text"
}

Get audio metadata

get

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

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

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 /audio-management/audio/{id}/metadata HTTP/1.1
Host: api.gomobile.io
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": "2025-12-19T15:48:02.728Z",
  "updatedAt": "2025-12-19T15:48:02.728Z",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "fileSize": 1,
    "checksum": "text"
  }
}

Get audio with relations

get

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

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

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 /audio-management/audio/{id}/details HTTP/1.1
Host: api.gomobile.io
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": "2025-12-19T15:48:02.728Z",
  "updatedAt": "2025-12-19T15:48:02.728Z",
  "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

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

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

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 /audio-management/audio/{id}/playback-url HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "playbackUrl": "text",
  "expiresIn": 1,
  "expiresAt": "2025-12-19T15:48:02.728Z"
}

Get audio by usage type

get

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

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

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 /audio-management/audios/usage/{usageType} HTTP/1.1
Host: api.gomobile.io
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": "2025-12-19T15:48:02.728Z",
    "updatedAt": "2025-12-19T15:48:02.728Z",
    "file": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "contentType": "text",
      "fileSize": 1,
      "checksum": "text"
    }
  }
]