Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/myoddly-com:myoddly-com-playbooks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Oddly Platform Playbooks API
version: 1.0.0
description: 'Programmatic access to oddly''s deterministic commerce primitives for agents, automations, and partner tools. Authenticate with a bearer key minted at /dashboard/developers. Receipts are the rail: every response is traceable to the exact rule that produced it, so an answer is auditable, cacheable, and reproducible. All v1 endpoints are deterministic: same inputs, same outputs, no model in the hot path.'
servers:
- url: https://myoddly.com
security:
- bearerAuth: []
tags:
- name: Playbooks
description: Playbook run history and rule coverage.
paths:
/api/v1/playbooks/{id}/runs:
get:
operationId: listPlaybookRuns
tags:
- Playbooks
summary: List a playbook's run history
description: Autopilot tier and up. Scoped to the playbook's owning account.
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: cursor
in: query
required: false
description: Opaque pagination cursor from a previous response's meta.next_cursor.
schema:
type: string
- name: limit
in: query
required: false
description: Page size. Default 25, max 100.
schema:
type: integer
minimum: 1
maximum: 100
default: 25
responses:
'200':
description: Playbook runs.
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
'401':
description: Authentication failed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Tier upgrade required.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Playbook not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/playbooks/rules/coverage:
get:
operationId: getRulesCoverage
tags:
- Playbooks
summary: Report which rules currently match for a brand
description: Runs each rule read-only (no playbook is fired, no run row is written) and reports match plus candidate context. Autopilot tier and up.
parameters:
- name: rule_id
in: query
required: false
description: Restrict to one rule. Omit for the full registry.
schema:
type: string
- name: brand_id
in: query
required: false
description: Brand to scope the read to. Required when the account owns more than one brand.
schema:
type: string
responses:
'200':
description: Per-rule coverage.
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
'400':
description: Invalid request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication failed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Tier upgrade required.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Rule or brand not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- type
- code
- message
- request_id
properties:
type:
type: string
enum:
- invalid_request
- auth_invalid
- tier_required
- not_found
- rate_limited
- server_error
code:
type: string
message:
type: string
details:
type: object
nullable: true
request_id:
type: string
Envelope:
type: object
required:
- data
- meta
properties:
data:
type: object
description: The resource payload. Shape depends on the endpoint.
meta:
$ref: '#/components/schemas/Meta'
Meta:
type: object
required:
- request_id
- api_version
- tier
properties:
request_id:
type: string
description: Echoed in the X-Request-Id header. Quote it in support tickets.
api_version:
type: string
enum:
- v1
tier:
type: string
description: The caller's tier at request time.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: oddly_live_*
description: 'API key minted at /dashboard/developers. Send as: Authorization: Bearer oddly_live_...'