---
title: "Start uploaded RVC training"
method: POST
path: "/api/agent/v1/jobs/{jobId}/start"
tags: ["Training"]
---

# Start uploaded RVC training

`POST /api/agent/v1/jobs/{jobId}/start`

## Request

- Base URL: `https://nicevois.com`
- URL: `https://nicevois.com/api/agent/v1/jobs/{jobId}/start`
- Auth: HTTP bearer

Call only after the audio PUT completed successfully. This starts cloud compute.

## Path parameters

- `jobId` string, required

## Response `202`

Training accepted.

- TrainingJob
  - `id` string, required
  - `status` string, required
  - `message` string, nullable
  - `modelName` string, nullable
  - `epochs` integer, nullable
  - `currentEpoch` integer, nullable, required
  - `durationSeconds` number, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `startedAt` string, date-time, nullable
  - `completedAt` string, date-time, nullable
  - `estimatedCompletionAt` string, date-time, nullable
  - `estimatedRemainingSeconds` number, nullable
  - `etaText` string, nullable
  - `expiresAt` string, date-time, nullable
  - `subscriptionCreditCents` integer
  - `balanceDueCents` integer
  - `upload` UploadInstruction
    - `method` 'PUT', required
    - `url` string, uri, required
    - `headers` object, required
  - `artifacts` Artifacts
    - `pth` Artifact
      - `name` string, nullable
      - `sizeBytes` integer, nullable
      - `downloadUrl` string, uri
    - `index` Artifact
      - `name` string, nullable
      - `sizeBytes` integer, nullable
      - `downloadUrl` string, uri
    - `package` Artifact
      - `name` string, nullable
      - `sizeBytes` integer, nullable
      - `downloadUrl` string, uri
  - `links` object, required
    - `status` string, uri, required
    - `start` string, uri, required

## Other responses

- `401`: Missing or invalid NiceVois agent credential.
- `402`: The connected account needs more training balance. The error includes the exact shortfall and a short-lived same-account browser link.
- `404`: The private job was not found for this credential.

---

[API](https://skmtc.dev/nicevois/apis/nicevois-agent-api.md) · [All operations](https://skmtc.dev/nicevois/apis/nicevois-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicevois/apis/nicevois-agent-api/revisions/6ef41022a089?raw)