# Surge API

**Canonical:** https://apis.io/apis/surge-ai/surge-api/  
**Provider:** Surge AI — https://apis.io/providers/surge-ai/  
**Documentation:** https://app.surgehq.ai/docs/api

Surge API is one of 14 APIs that [Surge AI](https://apis.io/providers/surge-ai/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include REST API, Project, Task, and Blueprints. The published artifact set on APIs.io includes API documentation, an API reference, and authentication docs.

Surge's REST API for managing labeling projects, tasks, and results. Endpoints cover projects (list, retrieve, create, download results, save reports in multiple formats), tasks (create, list, retrieve individual tasks), and blueprints (list and use as templates for new projects). Authentication uses an API key sourced from the user's Surge profile, passed via the SURGE_API_KEY environment variable or set explicitly on the client. The reference is published in the Surge dashboard at app.surgehq.ai/docs/api.

## Machine-readable artifacts (5)

- **Documentation** — https://app.surgehq.ai/docs/api
- **APIReference** — https://app.surgehq.ai/docs/api
- **Authentication** — https://app.surgehq.ai/docs/api
- **SDKs** — https://github.com/surge-ai/surge-python
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/surge-ai/refs/heads/main/apis.yml

## Other Surge AI APIs (12)

- [Surge Python SDK](https://apis.io/apis/surge-ai/surge-python-sdk/)
- [Surge RL Environments and Agents](https://apis.io/apis/surge-ai/surge-rl-environments/)
- [Surge Rubrics and Verifiers](https://apis.io/apis/surge-ai/surge-rubrics-verifiers/)
- [Surge RLHF](https://apis.io/apis/surge-ai/surge-rlhf/)
- [Surge SFT](https://apis.io/apis/surge-ai/surge-sft/)
- [Surge Human Evaluation](https://apis.io/apis/surge-ai/surge-human-evaluation/)
- [Surge Multimodal Data](https://apis.io/apis/surge-ai/surge-multimodal/)
- [Surge Internationalization](https://apis.io/apis/surge-ai/surge-internationalization/)
- [Surge Off-The-Shelf Data](https://apis.io/apis/surge-ai/surge-off-the-shelf-data/)
- [Surge Toxicity Dataset](https://apis.io/apis/surge-ai/surge-toxicity-dataset/)
- [Surge AI Projects API](https://apis.io/apis/surge-ai/surge-ai-projects-api/)
- [Surge AI Tasks API](https://apis.io/apis/surge-ai/surge-ai-tasks-api/)

## Tags

REST API, Project, Task, Blueprints

---

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