# Jokes One API

> Jokes One API skill. Use when working with Jokes One for jod, joke. Covers 12 endpoints.

- Skill: `lap-platform/jokes-one-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lap-platform/jokes-one-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lap-platform/jokes-one-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Lap-Platform (https://skillmd.com/u/lap-platform)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/lap-platform/jokes-one-api

---


# Jokes One API
API version: 1.1

## Auth
ApiKey X-JokesOne-Api-Secret in header

## Base URL
https://api.jokes.one

## Setup
1. Set your API key in the appropriate header
2. GET /jod -- verify access
3. POST /joke/tags/add -- create first add

## Endpoints

12 endpoints across 2 groups. See references/api-spec.lap for full details.

### jod
| Method | Path | Description |
|--------|------|-------------|
| GET | /jod | Gets `Joke of the Day`. |
| GET | /jod/categories | Gets a list of `Joke of the Day` Categories. |

### joke
| Method | Path | Description |
|--------|------|-------------|
| PUT | /joke | Add a new joke to your private collection. |
| PATCH | /joke | Update a joke |
| GET | /joke | Gets a `Joke` with a given `id`. |
| DELETE | /joke | Delete a joke. The user needs to be the owner of the joke to be able to delete it. |
| GET | /joke/random | Gets a `Random Joke`. When you are in a hurry this is what you call to get a random famous joke. |
| GET | /joke/search | Search for a `Joke` in Jokes One platform. Optional `category` , `author`, `minlength`, `maxlength` params determines the filters applied while searching for the joke. |
| GET | /joke/categories/search | Gets a list of `Joke` Categories, based on a query term. |
| GET | /joke/list | Get the list of jokes in your private collection. |
| POST | /joke/tags/add | Add a tag to a given Joke. |
| POST | /joke/tags/remove | Remove a tag from a given joke. |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all jod?" -> GET /jod
- "List all categories?" -> GET /jod/categories
- "List all joke?" -> GET /joke
- "List all random?" -> GET /joke/random
- "Search search?" -> GET /joke/search
- "Search search?" -> GET /joke/categories/search
- "List all list?" -> GET /joke/list
- "Create a add?" -> POST /joke/tags/add
- "Create a remove?" -> POST /joke/tags/remove
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Create/update endpoints typically return the created/updated object

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)