# satohub-ai Projects API

**Canonical:** https://apis.io/apis/satohub-ai/satohub-ai-projects-api/  
**Provider:** satohub-ai — https://apis.io/providers/satohub-ai/  
**Base URL:** https://satohub.ai  
**Documentation:** https://satohub.ai/docs/api

satohub-ai Projects API is one of 21 APIs that [satohub-ai](https://apis.io/providers/satohub-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include projects. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Private agent projects and their immutable sealed versions. Owner-only: every operation resolves the owner from the Privy bearer, never from a body field, and a caller who does not own the object gets 404 — never 403, which would confirm it exists.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/projects` | Create a private project |
| GET | `/api/projects` | List your projects |
| GET | `/api/projects/{id}` | Read one project |
| PATCH | `/api/projects/{id}` | Update the draft |
| POST | `/api/projects/{id}/archive` | Archive a project |
| POST | `/api/projects/adopt` | Adopt a browser-held anonymous draft |
| POST | `/api/projects/{id}/versions` | Seal an immutable version |
| GET | `/api/projects/{id}/versions` | List a project's versions |
| GET | `/api/versions/{id}` | Read a sealed version |
| GET | `/api/versions/{id}/artifact` | Download the sealed archive |
| GET | `/api/versions/{id}/manifest` | Download the signed manifest |
| POST | `/api/versions/{id}/evidence` | Attach an observation to a sealed version |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/satohub-ai/openapi/satohub-ai-projects-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-version-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-interpretation-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-needs-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-scan-recipient-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-token-resolve-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-swap-receipt-schema.json

## Other satohub-ai APIs (12)

- [satohub-ai Agent Economy API](https://apis.io/apis/satohub-ai/satohub-ai-agent-economy-api/)
- [satohub-ai Badges API](https://apis.io/apis/satohub-ai/satohub-ai-badges-api/)
- [satohub-ai Check API](https://apis.io/apis/satohub-ai/satohub-ai-check-api/)
- [satohub-ai Claims API](https://apis.io/apis/satohub-ai/satohub-ai-claims-api/)
- [satohub-ai Create API](https://apis.io/apis/satohub-ai/satohub-ai-create-api/)
- [satohub-ai Directory API](https://apis.io/apis/satohub-ai/satohub-ai-directory-api/)
- [satohub-ai Erc8004 API](https://apis.io/apis/satohub-ai/satohub-ai-erc8004-api/)
- [satohub-ai Listings API](https://apis.io/apis/satohub-ai/satohub-ai-listings-api/)
- [satohub-ai Preflight API](https://apis.io/apis/satohub-ai/satohub-ai-preflight-api/)
- [satohub-ai Registry API](https://apis.io/apis/satohub-ai/satohub-ai-registry-api/)
- [satohub-ai Resolve API](https://apis.io/apis/satohub-ai/satohub-ai-resolve-api/)
- [satohub-ai Route API](https://apis.io/apis/satohub-ai/satohub-ai-route-api/)

## Tags

projects

---

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