# Floop API

Scoped machine-readable index for Floop's REST API.

## Entry Points

- API reference: https://floop.ing/api
- OpenAPI spec: https://floop.ing/v1/openapi.json
- Production base URL: https://api.floop.ing/v1/
- Pricing: https://floop.ing/pricing.md

## Authentication

Use `Authorization: Bearer fl_live_...` for authenticated API calls. The no-key task proposal endpoint does not require auth.

OAuth 2.0 is not supported yet; use the no-key claim flow or Bearer API keys.

## Cold Start

`POST /v1/tasks/propose` lets an agent propose a task before the human has an API key. Send the returned `humanClaimUrl` to the human, then wait for claim completion.

## Key Endpoints

- `POST /v1/tasks/propose` - propose a no-key task for human claim
- `POST /v1/tasks` - create an authenticated task
- `GET /v1/tasks/:id` - fetch task state and proof metadata
- `POST /v1/webhooks` - register signed lifecycle webhooks
- `GET /v1/workers` - discover workers