---
title: "List remote model uploads"
method: GET
path: "/v2/projects/{projectId}/models/uploads"
tags: ["VolumeService"]
---

# List remote model uploads

`GET /v2/projects/{projectId}/models/uploads`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v2/projects/{projectId}/models/uploads`
- Auth: HTTP bearer

Lists asynchronous jobs that import model files from Hugging Face or a presigned remote URL.

## Path parameters

- `projectId` string, required: Project identifier.

## Query parameters

- `limit` integer: Maximum number of uploads to return.
- `after` string: Cursor from a previous remote upload list response.

## Response `200`

OK

- DEListRemoteUploadsResponse: Remote model import jobs and pagination metadata.
  - `data` DERemoteUpload[], required: Remote upload jobs.
    - `id` string, required: Unique ID of the remote model import job.
    - `projectId` string, required: ID of the project that owns the import job.
    - `modelId` string, required: ID of the registered model receiving the imported files.
    - `remoteUrl` string, required: Hugging Face repository or presigned URL being imported.
    - `status` 'REMOTE_UPLOAD_STATUS_PENDING' | 'REMOTE_UPLOAD_STATUS_RUNNING' | 'REMOTE_UPLOAD_STATUS_ERROR' | 'REMOTE_UPLOAD_STATUS_SUCCEEDED' | 'REMOTE_UPLOAD_STATUS_FAILED', required: Current lifecycle state of the asynchronous import job.
    - `statusMessage` string: Human-readable progress or failure detail for the current status.
    - `restartCount` integer: Number of times the import worker has restarted this job.
    - `maxRestarts` integer: Maximum worker restarts allowed before the job fails permanently.
    - `createdAt` string, date-time, required: Time when the import job was created.
    - `updatedAt` string, date-time: Time when the import job was last updated.
  - `next_cursor` string: Cursor for the next page. Null if there are no more results.
  - `object` 'list', required: Object type. Always `list`.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v2/projects/:projectId/models/uploads/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)