---
slug: developer-api-overview
title: Public Task API overview
category: capability
status: published
tags: [api, public api, developer, integration, async, task api, 接口, 开发者, 集成]
aliases: []
lastEditAt: 2026-08-02
---
The Public Task API lets a backend hand Tycoon a complete outcome and receive
the finished result later. It is asynchronous: `POST /tasks` returns a Task id,
the existing Tycoon orchestration system does the work, and the caller polls or
waits for a signed terminal webhook.

Base URL: `https://tycoon.us/api/public`

## In this collection

- [Quickstart: create your first Task](/help/developer-api-quickstart) — Mint a key, create one Task, and read it to a usable result in five minutes.
- [Authentication and workspace billing](/help/developer-api-authentication-billing) — How keys are minted and revoked, which workspace pays, and where Tasks execute.
- [Publish a workspace method as an API](/help/developer-api-published-method) — Pin a Company Skill, execution profile, and bounded Task allocation to one customer key.
- [Create and read Tasks](/help/developer-api-create-read-tasks) — The create request, the read response, and what each status means.
- [Long-running outcomes](/help/developer-api-long-running-outcomes) — Targets, deadlines, Metrics, and Playbooks for work that outlives one turn.
- [Messages, actions, and approvals](/help/developer-api-actions-approvals) — Add direction while work is open, and resolve a decision from your backend.
- [Webhooks](/help/developer-api-webhooks) — Register a receiver, verify the signature, and deduplicate deliveries.
- [Idempotency, retries, errors, and limits](/help/developer-api-reliability-errors) — Retry safely without duplicating work, and read every error the API returns.

## Next steps

- [Quickstart: create your first Task](/help/developer-api-quickstart)
- [Publish a workspace method as an API](/help/developer-api-published-method)
- [Authentication and workspace billing](/help/developer-api-authentication-billing)