GET personas

GET/personas

Provides a download URL to a zip file of personas from the active exercise.

The download URL is valid for 15mins after request.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Empty

Response

presigned_url	string	URL to the persona zip file

200

{
  "presigned_url": "https://...personas.zip?Expires=....Signature=...xxxx"
}

400

{
  "error": "Invalid request"
}

Code segment

To access the personas, the flow is:

1. Call the Conducttr /personas endpoint to get a presigned URL

2. Download the ZIP file from that URL

3. Extract the first .json file from the archive - this will be an array of persona json objects

4. Parse and return the JSON content - see the persona object here

Core concepts

code segment

GET /api/personas endpoint

app.get("/api/personas", async (_req, res) => {
  const AUTH_KEY = process.env.AUTH_KEY;
  if (!AUTH_KEY) {
    return res.status(500).json({ error: "AUTH_KEY not configured" });
  }

  // Step 1: Get the presigned URL for the personas file
  const presignedRes = await fetch(
    "https://api.conducttr.com/v1.1/eagle/personas",
    {
      headers: { Authorization: `Bearer ${AUTH_KEY}` },
    }
  );

  if (!presignedRes.ok) {
    return res.status(presignedRes.status).json({
      error: "Failed to fetch personas presigned URL",
    });
  }

  const presignedData = await presignedRes.json();
  const zipUrl = presignedData.presigned_url;

  // Step 2: Download the ZIP file
  const zipRes = await fetch(zipUrl);
  const zipBuffer = await zipRes.arrayBuffer();

  // Step 3: Unzip and extract the JSON file
  const zip = await JSZip.loadAsync(zipBuffer);
  const jsonFileName = Object.keys(zip.files).find((name) =>
    name.endsWith(".json")
  );

  if (!jsonFileName) {
    return res.status(500).json({ error: "No JSON file found in ZIP" });
  }

  const jsonContent = await zip.files[jsonFileName].async("string");
  const personasData = JSON.parse(jsonContent);

  res.json(personasData);
});