Change an application's language or sitting

curl -s https://api.main-team.org/v1/<organizationId>/application/66e6a4b1c1d2b30012a4fa07 \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "message": "Application fetched successfully.",
  "data": {
    "_id": "66e6a4b1c1d2b30012a4fa07",
    "exam": {
      "_id": "64c0a1b2c3d4e5f601234801",
      "session": "64c0a1b2c3d4e5f601234601",
      "category": "64c0a1b2c3d4e5f601234501",
      "language": "64c0a1b2c3d4e5f601234701",
      "grades": ["630e01826836e67ec53dc7a6"],
      "price": 25
    },
    "user": {
      "_id": "66e6a41fc1d2b30012a4f9f3",
      "mainId": "66e6a3f5c1d2b30012a4f9c1",
      "firstName": "Jane",
      "lastName": "Doe"
    },
    "payment": {
      "_id": "66e6a4b1c1d2b30012a4fa09",
      "amount": 25,
      "status": "paid"
    },
    "participated": false
  }
}

curl -s "https://api.main-team.org/v1/<organizationId>/exam?page=1&limit=100" \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "message": "Exams fetched successfully.",
  "data": [
    {
      "_id": "64c0a1b2c3d4e5f601234802",
      "session": { "_id": "64c0a1b2c3d4e5f601234601", "date": "2026-11-14T09:00:00.000Z" },
      "category": { "_id": "64c0a1b2c3d4e5f601234501", "name": "Mathematics" },
      "language": { "_id": "64c0a1b2c3d4e5f601234702", "name": "German", "code": "de" },
      "grades": [{ "_id": "630e01826836e67ec53dc7a6", "name": "10" }],
      "countries": [],
      "price": 25
    }
  ],
  "pagination": { "page": 1, "limit": 100, "total": 38, "totalPages": 1 }
}

curl -s https://api.main-team.org/v1/<organizationId>/exam/available/66e6a3f5c1d2b30012a4f9c1 \
  -H "Authorization: Bearer $TOKEN"

curl -s -X PUT https://api.main-team.org/v1/<organizationId>/application/66e6a4b1c1d2b30012a4fa07 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "examId": "64c0a1b2c3d4e5f601234802" }'

{
  "success": true,
  "message": "Application updated successfully.",
  "data": {
    "_id": "66e6a4b1c1d2b30012a4fa07",
    "exam": "64c0a1b2c3d4e5f601234802",
    "user": "66e6a41fc1d2b30012a4f9f3",
    "payment": "66e6a4b1c1d2b30012a4fa09"
  }
}

curl -s https://api.main-team.org/v1/<organizationId>/application/66e6a4b1c1d2b30012a4fa07 \
  -H "Authorization: Bearer $TOKEN"

curl -s -X DELETE https://api.main-team.org/v1/<organizationId>/application/66e6a4b1c1d2b30012a4fa07 \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "message": "Application deleted successfully.",
  "data": { "_id": "66e6a4b1c1d2b30012a4fa07", "exam": "64c0a1b2c3d4e5f601234802" }
}

// change-application.mjs: move an application to another language or sitting.
// Usage:
//   node change-application.mjs stem <applicationId> language de
//   node change-application.mjs stem <applicationId> sitting
import { api, ApiError } from './mainteam.mjs';

const [slug, applicationId, mode, languageCode] = process.argv.slice(2);
if (!slug || !applicationId || !['language', 'sitting'].includes(mode) || (mode === 'language' && !languageCode)) {
  console.error('Usage: node change-application.mjs <slug> <applicationId> language <code> | sitting');
  process.exit(2);
}

// A reference may arrive as a document or as a bare id.
const idOf = (value) => (value && typeof value === 'object' ? value._id : value);

async function organizationId(wanted) {
  const res = await api('GET', '/organization?limit=100');
  const org = res.data.find((candidate) => candidate.slug === wanted);
  if (!org) throw new Error(`No organization with slug ${wanted}.`);
  return org._id;
}

async function openExams(orgId) {
  const exams = [];
  for (let page = 1; ; page++) {
    const res = await api('GET', `/${orgId}/exam?page=${page}&limit=100`);
    exams.push(...res.data);
    if (page >= res.pagination.totalPages) return exams;
  }
}

async function main() {
  const orgId = await organizationId(slug);
  const { data: application } = await api('GET', `/${orgId}/application/${applicationId}`);
  const current = application.exam; // a document; its session, category and language are ids
  const payment = application.payment;
  const settled = payment?.status === 'paid' && payment.amount > 0;
  const studentId = application.user.mainId;
  const fits = (exam) => !settled || (exam.price ?? 0) === payment.amount;

  console.log(`Application ${application._id} for ${application.user.firstName} ${application.user.lastName}`);
  console.log(`  now: exam ${current._id}, payment ${payment?.status ?? 'none'} ${payment?.amount ?? ''}`);

  if (application.participated || application.examSubmitted) {
    console.log('  The exam has been started, so it can no longer be moved.');
    return;
  }

  let target;
  if (mode === 'language') {
    const { data: student } = await api('GET', `/student/${studentId}`);
    const gradeId = idOf(student?.grade);
    target = (await openExams(orgId)).find(
      (exam) =>
        idOf(exam.session) === idOf(current.session) &&
        idOf(exam.category) === idOf(current.category) &&
        exam.language?.code === languageCode &&
        exam.grades.some((grade) => idOf(grade) === gradeId) &&
        fits(exam),
    );
  } else {
    const { data: tree } = await api('GET', `/${orgId}/exam/available/${studentId}`);
    const category = tree.find((node) => node._id === idOf(current.category));
    const candidates = (category?.sessions ?? [])
      .flatMap((session) => session.languages.map((language) => language.matchedExam))
      .filter(fits);
    target = candidates.find((exam) => exam.language === idOf(current.language)) ?? candidates[0];
  }

  if (!target) {
    console.log('  No suitable exam was found. Nothing was changed.');
    return;
  }
  console.log(`  target: exam ${target._id} (price ${target.price ?? 0})`);

  const moved = await api('PUT', `/${orgId}/application/${applicationId}`, { examId: target._id });
  console.log(`  ${moved.message}`);

  const { data: after } = await api('GET', `/${orgId}/application/${applicationId}`);
  console.log(`  now: exam ${after.exam._id}, payment ${after.payment?.status} ${after.payment?.amount}`);
}

main().catch((error) => {
  if (error instanceof ApiError) {
    console.error(`${error.status} ${error.code}: ${error.message} (request ${error.requestId})`);
  } else {
    console.error(error);
  }
  process.exitCode = 1;
});

<?php
// change-application.php: move an application to another language or sitting.
// Usage:
//   php change-application.php stem <applicationId> language de
//   php change-application.php stem <applicationId> sitting
declare(strict_types=1);
require __DIR__ . '/mainteam.php';

[$slug, $applicationId, $mode, $languageCode] = array_pad(array_slice($argv, 1), 4, null);
if ($slug === null || $applicationId === null || !in_array($mode, ['language', 'sitting'], true)
    || ($mode === 'language' && $languageCode === null)) {
    fwrite(STDERR, "Usage: php change-application.php <slug> <applicationId> language <code> | sitting\n");
    exit(2);
}

// A reference may arrive as a document or as a bare id.
function idOf(mixed $value): ?string
{
    return is_array($value) ? ($value['_id'] ?? null) : $value;
}

function organizationId(MainTeam $api, string $wanted): string
{
    foreach ($api->call('GET', '/organization?limit=100')['data'] as $org) {
        if ($org['slug'] === $wanted) {
            return $org['_id'];
        }
    }
    throw new RuntimeException("No organization with slug $wanted.");
}

function openExams(MainTeam $api, string $orgId): array
{
    $exams = [];
    for ($page = 1; ; $page++) {
        $res = $api->call('GET', "/$orgId/exam?page=$page&limit=100");
        array_push($exams, ...$res['data']);
        if ($page >= $res['pagination']['totalPages']) {
            return $exams;
        }
    }
}

$api = MainTeam::fromEnv();

try {
    $orgId = organizationId($api, $slug);
    $application = $api->call('GET', "/$orgId/application/$applicationId")['data'];
    $current = $application['exam']; // a document; its session, category and language are ids
    $payment = $application['payment'] ?? null;
    $settled = ($payment['status'] ?? null) === 'paid' && ($payment['amount'] ?? 0) > 0;
    $studentId = $application['user']['mainId'];
    $fits = fn (array $exam): bool => !$settled || ($exam['price'] ?? 0) == $payment['amount'];

    echo "Application {$application['_id']} for {$application['user']['firstName']} {$application['user']['lastName']}\n";
    printf("  now: exam %s, payment %s %s\n", $current['_id'], $payment['status'] ?? 'none', $payment['amount'] ?? '');

    if (!empty($application['participated']) || !empty($application['examSubmitted'])) {
        echo "  The exam has been started, so it can no longer be moved.\n";
        exit(0);
    }

    $target = null;
    if ($mode === 'language') {
        $student = $api->call('GET', "/student/$studentId")['data'] ?? null;
        $gradeId = idOf($student['grade'] ?? null);
        foreach (openExams($api, $orgId) as $exam) {
            $gradeIds = array_map('idOf', $exam['grades'] ?? []);
            if (idOf($exam['session']) === idOf($current['session'])
                && idOf($exam['category']) === idOf($current['category'])
                && ($exam['language']['code'] ?? null) === $languageCode
                && in_array($gradeId, $gradeIds, true)
                && $fits($exam)) {
                $target = $exam;
                break;
            }
        }
    } else {
        $tree = $api->call('GET', "/$orgId/exam/available/$studentId")['data'];
        $candidates = [];
        foreach ($tree as $category) {
            if ($category['_id'] !== idOf($current['category'])) {
                continue;
            }
            foreach ($category['sessions'] as $session) {
                foreach ($session['languages'] as $language) {
                    if ($fits($language['matchedExam'])) {
                        $candidates[] = $language['matchedExam'];
                    }
                }
            }
        }
        foreach ($candidates as $exam) {
            if ($exam['language'] === idOf($current['language'])) {
                $target = $exam;
                break;
            }
        }
        $target ??= $candidates[0] ?? null;
    }

    if ($target === null) {
        echo "  No suitable exam was found. Nothing was changed.\n";
        exit(0);
    }
    printf("  target: exam %s (price %s)\n", $target['_id'], $target['price'] ?? 0);

    $moved = $api->call('PUT', "/$orgId/application/$applicationId", ['examId' => $target['_id']]);
    echo "  {$moved['message']}\n";

    $after = $api->call('GET', "/$orgId/application/$applicationId")['data'];
    printf("  now: exam %s, payment %s %s\n", $after['exam']['_id'], $after['payment']['status'] ?? '-', $after['payment']['amount'] ?? '-');
} catch (ApiError $e) {
    fwrite(STDERR, "{$e->status} {$e->errorCode}: {$e->getMessage()} (request {$e->requestId})\n");
    exit(1);
}

$ node change-application.mjs stem 66e6a4b1c1d2b30012a4fa07 language de
Application 66e6a4b1c1d2b30012a4fa07 for Jane Doe
  now: exam 64c0a1b2c3d4e5f601234801, payment paid 25
  target: exam 64c0a1b2c3d4e5f601234802 (price 25)
  Application updated successfully.
  now: exam 64c0a1b2c3d4e5f601234802, payment paid 25

$ node change-application.mjs stem 66e6a4b1c1d2b30012a4fa07 sitting
Application 66e6a4b1c1d2b30012a4fa07 for Jane Doe
  now: exam 64c0a1b2c3d4e5f601234801, payment paid 0
  target: exam 64c0a1b2c3d4e5f601234901 (price 30)
  Application updated successfully.
  now: exam 64c0a1b2c3d4e5f601234901, payment pending 30

409 conflict: Student already has an application for Mathematics on this sitting. Two exams in one category on one date cannot both be sat. (request 5b2d8c1e-0f3a-4e7b-9c61-2a4d7e8f9b10)