# Appen Upload API

**Canonical:** https://apis.io/apis/appen/appen-upload-api/  
**Provider:** Appen — https://apis.io/providers/appen/  
**Base URL:** https://api.appen.com  
**Documentation:** https://developer.appen.com/open-api.yaml

Appen Upload API is one of 8 APIs that [Appen](https://apis.io/providers/appen/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Upload. The published artifact set on APIs.io includes an OpenAPI specification.

File upload operations for importing datasets and data into your projects and jobs. - **Dataset Upload Process:** - **Upload Files**: Send CSV files containing your data to existing projects - **Status Monitoring**: Track upload progress and completion status - **File Validation**: Automatic validation of CSV format, headers, and content - **Supported File Formats:** - **CSV Files**: Primary format for data import - **Encoding**: UTF-8 encoding recommended - **Headers**: Required column headers for data organization - **Data Types**: Text, numeric, date, and structured data support - **Upload Workflow:** 1. **File Preparation**: Ensure CSV format with proper headers 2. **Upload Initiation**: Send file to project with metadata 3. **Processing**: System validates and processes the data 4. **Status Polling**: Monitor status until completion 5. **Data Integration**: Units become available for job assignments - **Key Features:** - **Batch Processing**: Handle large datasets efficiently - **Progress Tracking**: Real-time upload status monitoring - **Error Handling**: Detailed validation error messages - **File Management**: Track uploaded files and their metadata - **Integration Points:** - **Project Association**: Uploads are linked to specific projects - **Unit Creation**: Each row becomes a unit for annotation - **Job Routing**: Units can be sent to jobs for contributor work

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| POST | `/v3/jobs/upload.json` | Upload unit data to an existing project |
| GET | `/v3/jobs/upload/status` | Get the status of an uploaded file/dataset |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/appen/refs/heads/main/openapi/appen-upload-api-openapi.yml

## Other Appen APIs (7)

- [Appen AI Data Annotation Platform API](https://apis.io/apis/appen/appen-ai-data-annotation-platform-api/)
- [Appen Download API](https://apis.io/apis/appen/appen-download-api/)
- [Appen Internal Contributors API](https://apis.io/apis/appen/appen-internal-contributors-api/)
- [Appen Jobs API](https://apis.io/apis/appen/appen-jobs-api/)
- [Appen Projects API](https://apis.io/apis/appen/appen-projects-api/)
- [Appen Route Units API](https://apis.io/apis/appen/appen-route-units-api/)
- [Appen Test Questions API](https://apis.io/apis/appen/appen-test-questions-api/)

## Tags

Upload

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/appen/appen-upload-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/appen/.