# Joocy API

**Canonical:** https://apis.io/apis/joo-cy/joo-cy-api/  
**Provider:** Joocy — https://apis.io/providers/joo-cy/  
**Documentation:** https://joo.cy/api/v1/guide

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

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

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/decks` | Interactive presentations. Every slide has a big-screen side and a phone side. |
| POST | `/api/v1/decks` | Interactive presentations. Every slide has a big-screen side and a phone side. |
| GET | `/api/v1/decks/{id}` | Interactive presentations. Every slide has a big-screen side and a phone side. |
| POST | `/api/v1/files/from-url` | Interactive presentations. Every slide has a big-screen side and a phone side. |
| GET | `/api/v1/guide` | Joocy: the guide for agents |
| GET | `/catalog` | The full machine‑readable list of everything you can use |
| GET | `/decks` | Find it: GET /decks lists them all (or with ?q= for search) |
| POST | `/decks` | A new deck (whenever the request does not name one they have) |
| GET | `/decks/{id}` | GET /decks/{id} reads one deck |
| PATCH | `/decks/{id}` | Change it with PATCH /decks/{id} and a list of ops |
| PUT | `/decks/{id}` | Replace it whole with PUT /decks/{id} |
| POST | `/decks/{id}/duplicate` | Copies a deck they have, with its uploaded files, to make something new from it |
| PUT | `/decks/{id}/meta` | Move or star a deck. |
| POST | `/decks/{id}/present` | Start or resume a live session. |
| POST | `/decks/{id}/sources/{sourceid}/apply` | Apply uploaded files to the deck. |
| PUT | `/decks/{id}/sources/{sourceid}/files/index.html` | Upload the HTML file for a coded deck. |
| DELETE | `/decks/{id}/sources/{sourceid}/files/{path}` | Delete a file from a coded deck. |
| POST | `/decks/{id}/validate` | POST /decks/{id}/validate checks a spec without saving |
| GET | `/decks/{id}/versions` | GET /decks/{id}/versions lists saved versions |
| POST | `/decks/{id}/versions/{v}/restore` | POST /decks/{id}/versions/{v}/restore goes back to a previous version |
| POST | `/files` | Upload bytes for a file (e.g., picture) |
| POST | `/files/from-url` | Copies a picture from a URL and returns a local URL |
| GET | `/folders` | List folders with deck counts. |
| POST | `/folders` | Create a new folder. |
| DELETE | `/folders/{id}` | Remove a folder. |
| PATCH | `/folders/{id}` | Rename a folder. |
| GET | `/sessions` | Interactive presentations. Every slide has a big-screen side and a phone side. |
| GET | `/sessions/{sid}` | Get the session state and info. |
| POST | `/sessions/{sid}/control` | Drive a live session. |
| GET | `/sessions/{sid}/results` | Return every answer rolled up per question. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/joo-cy/openapi/_ae-authored/joo-cy-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/joo-cy/json-schema/joo-cy-post-sessions-sid-control-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/joo-cy/json-schema/joo-cy-post-decks-id-sources-sourceid-apply-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/joo-cy/json-schema/joo-cy-put-decks-id-meta-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/joo-cy/json-schema/joo-cy-put-decks-id-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/joo-cy/json-schema/joo-cy-patch-decks-id-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/joo-cy/json-schema/joo-cy-get-api-v1-decks-id-response-schema.json

## Other Joocy APIs (1)

- [Joocy API](https://apis.io/apis/joo-cy/joocy/)

---

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