Listing APPROVED Audio Recordings

You can retrieve a list of audio recordings that are approved for use with the Drop Cowboy API.

To filter only recordings allowed via the API, use the api_allowed=true query parameter.

Audio recordings can be used in RVM campaigns or other compatible endpoints.

---

Using the SDK

// Download the helper library from https://www.npmjs.com/package/dropcowboy
const { DropCowboy } = require("dropcowboy"); // Or, for ESM: import { DropCowboy } from "dropcowboy";

// Find your Team ID and Secret at dropcowboy.com/appv1/#/api
// and set the environment variables.
const teamId = process.env.DROPCOWBOY_TEAM_ID;
const secret = process.env.DROPCOWBOY_SECRET;
const client = new DropCowboy({ teamId: teamId, secret: secret });

async function getApprovedRecordings() {
      const recordings = await client.listRecordings({ api_allowed: true });

      console.log(recordings);
};

getApprovedRecordings();

---

API Endpoint

GET

https://api.dropcowboy.com/v1/recording?api_allowed=true

---

Example Request

Required Headers

• x-team-id - Your Team ID from API settings

• x-secret - Your Secret Key from API settings

Required Query Parameters

• api_allowed (boolean) - Filter results by whether recordings are API-approved (must be true)

List media

get

Invoke our recordings api from your application by sending an HTTP GET containing with the attributes listed.

Authorizations

teamSecretAuth

x-team-id / x-secretstringRequired

Requires two headers: x-team-id and x-secret. Both must be sent with each request.

Query parameters

api_allowedbooleanOptional

Filter brands by whether API access has been granted or not.

Responses

200

Array of recordings

application/json

get

/recording

HTTPcURLJavaScriptPython

GET /v1/recording HTTP/1.1
Host: api.dropcowboy.com
x-team-id / x-secret: YOUR_API_KEY
Accept: */*

200

Array of recordings

[
  {
    "media_id": "text",
    "name": "text",
    "created_at": 1,
    "api_allowed": true
  }
]

---

Example Response

The response will be an array of media objects