# TinyFish Runs API

**Canonical:** https://apis.io/apis/tinyfish/tinyfish-runs-api/  
**Provider:** TinyFish — https://apis.io/providers/tinyfish/  
**Base URL:** https://agent.tinyfish.ai  
**Documentation:** https://docs.tinyfish.ai/agent-api

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

Endpoints for retrieving automation run data

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/runs` | List and search runs |
| POST | `/v1/runs/batch` | Get multiple runs by IDs |
| POST | `/v1/runs/batch/cancel` | Cancel multiple runs by IDs |
| GET | `/v1/runs/{id}` | Get run by ID |
| POST | `/v1/runs/{id}/cancel` | Cancel run by ID |

## Machine-readable artifacts (1)

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

## Other TinyFish APIs (6)

- [TinyFish Automation API](https://apis.io/apis/tinyfish/tinyfish-automation-api/)
- [TinyFish TinyFish Browser API API](https://apis.io/apis/tinyfish/tinyfish-tinyfish-browser-api-api/)
- [TinyFish TinyFish Fetch API API](https://apis.io/apis/tinyfish/tinyfish-tinyfish-fetch-api-api/)
- [TinyFish TinyFish Search API API](https://apis.io/apis/tinyfish/tinyfish-tinyfish-search-api-api/)
- [TinyFish Usage API](https://apis.io/apis/tinyfish/tinyfish-usage-api/)
- [TinyFish Vault API](https://apis.io/apis/tinyfish/tinyfish-vault-api/)

## Tags

Runs

---

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