# Homespun API

**Canonical:** https://apis.io/apis/homespun-dev/homespun-dev-api/  
**Provider:** Homespun — https://apis.io/providers/homespun-dev/  
**Documentation:** https://docs.homespun.dev/reference/api.md

Homespun API is one of 2 APIs that [Homespun](https://apis.io/providers/homespun-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

Homespun API as documented publicly: 18 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/_hs/tasks` | A page can ask about its own row: |
| GET | `/authorize` | Restart sign‑in to obtain a fresh session grant. |
| GET | `/v1/apps` | List your apps (GET /v1/apps). |
| POST | `/v1/apps` | Create a new app (POST /v1/apps). |
| GET | `/v1/apps/{id}/collections/{name}` | Reading a collection |
| PATCH | `/v1/apps/{id}/collections/{name}/{key}` | Avoid lost updates with if_match |
| POST | `/v1/apps/{id}/collections/{name}/{key}/restore` | Restore a soft‑deleted row before updating or deleting it. |
| GET | `/v1/apps/{id}/connections` | List connections on the app. |
| DELETE | `/v1/apps/{id}/connections/{name}` | Delete an unused connection before creating another. |
| DELETE | `/v1/apps/{id}/domain` | Remove the current custom domain before adding another. |
| POST | `/v1/apps/{id}/domain` | Add a custom domain to the app. |
| POST | `/v1/apps/{id}/ingest-hooks/{name}/backfill` | Backfill a hook’s collection with historical data (POST /v1/apps/:id/ingest-hooks/:name/backfill). |
| POST | `/v1/apps/{id}/restore` | Restores a soft-deleted app with all its data, returning the app detail record. Idempotent on a live app. |
| POST | `/v1/apps/{id}/versions` | Redeploy an existing app (POST /v1/apps/:id/versions). |
| GET | `/v1/apps/{id}/webhooks/deliveries` | The delivery log is readable through GET /v1/apps/:id/webhooks/deliveries |
| POST | `/v1/attachments` | Upload the attachment and use the returned attachment_id. |
| POST | `/v1/ingest` | Send an inbound hook payload; the request must match the ingest rule. |
| POST | `/v1/register` | Register an agent directly via POST /v1/register. |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/homespun-dev/openapi/_ae-authored/homespun-dev-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/homespun-dev/json-schema/homespun-dev-get-v1-apps-id-collections-name-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/homespun-dev/json-schema/homespun-dev-patch-v1-apps-id-collections-name-key-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/homespun-dev/json-schema/homespun-dev-get-hs-tasks-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/homespun-dev/json-schema/homespun-dev-patch-v1-apps-id-collections-name-key-response-schema.json

## Other Homespun APIs (1)

- [Homespun API](https://apis.io/apis/homespun-dev/homespun-api/)

---

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