---
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:

```text
https://tycoon.us/api/public
```

## In this collection

- [Quickstart: create your first Task](/docs/quickstart) — Mint a key, create one Task, and read it to a usable result in five minutes.
- [Command line](/docs/cli) — Install the CLI and hand over a local file in one command.
- [Authentication and workspace billing](/docs/authentication-billing) — How keys are minted and revoked, which workspace pays, and where Tasks execute.
- [Publish a workspace method as an API](/docs/published-method) — Pin a Company Skill, execution profile, and bounded Task allocation to one customer key.
- [Create and read Tasks](/docs/create-read-tasks) — The create request, attaching files, the read response, and what each status means.
- [Long-running outcomes](/docs/long-running-outcomes) — Targets, deadlines, Metrics, and Playbooks for work that outlives one turn.
- [List and read your Tasks, Docs, and Skills](/docs/read-workspace) — Browse all Tasks this key created, read a Task's message thread, and fetch the Docs and Skills your workspace authored.
- [Messages, actions, and approvals](/docs/actions-approvals) — Add direction while work is open, and resolve a decision from your backend.
- [Webhooks](/docs/webhooks) — Register a receiver, verify the signature, and deduplicate deliveries.
- [Idempotency and errors](/docs/reliability-errors) — Retry safely without duplicating work, and read every error the API returns.

## Next steps

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