Orbit Recipes API
Recipe compositions — reusable sections and pages built from blocks
Recipe compositions — reusable sections and pages built from blocks
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/orbitapps-io:orbitapps-io-recipes-api"
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.
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: 3.2.0
info:
title: Orbit Apps Recipes API
version: 1.0.0
description: Public REST API for Orbit Apps.
servers:
- url: https://api.orbitapps.io
description: Production
security:
- bearerAuth: []
tags:
- name: Recipes
description: Recipe compositions — reusable sections and pages built from blocks
paths:
/api/v1/recipes:
get:
parameters:
- in: query
name: q
required: false
schema:
type: string
description: Natural-language BM25 query, e.g. `"hero"`, `"pricing page"`. Omit for plain browse + filter.
- in: query
name: kind
required: false
schema:
type: string
enum:
- section
- page
- example
- template
description: Recipe kind. `section` and `page` are the composable patterns; `example` is a single-block variant; `template` is a whole-app starting point.
- in: query
name: family
required: false
schema:
type: string
description: Restrict to one variant family, e.g. `header`.
- in: query
name: category
required: false
schema:
type: string
description: Restrict to a broader bucket, e.g. `marketing`.
- in: query
name: limit
required: false
schema:
type: integer
minimum: 1
maximum: 100
description: Max rows returned. 1–100, default 20.
- in: query
name: offset
required: false
schema:
type: integer
minimum: 0
description: Result offset for pagination. Default 0.
responses:
'200':
description: Matching recipes in the slim search shape.
content:
application/json:
schema:
title: RecipeList
description: List envelope. `limit` and `offset` echo the query; v1 omits a total count — detect end-of-results when `data.length < limit`.
type: object
properties:
data:
type: array
items:
title: RecipeMatch
description: Slim search hit. Read the full recipe via GET /recipes/{slug}.
type: object
properties:
slug:
description: URL-safe handle, unique within its kind. The path param on GET /recipes/{slug}.
type: string
kind:
description: Recipe kind.
type: string
title:
description: Human-readable display name.
type: string
description:
description: One-line summary for tooltips and ranking.
type: string
family:
description: Variant family, e.g. `header` for all header variants.
type: string
required:
- slug
- kind
- title
- description
additionalProperties: false
limit:
type: integer
offset:
type: integer
required:
- data
- limit
- offset
additionalProperties: false
tags:
- Recipes
summary: Search and browse reusable recipes
description: 'Returns the recipes the caller can reach.
Search semantics:
• Pass `q` for BM25 full-text ranking across title, slug, description, and keywords.
• Omit `q` to plain-browse with `kind`/`family`/`category` filters.
• Combine `q` with filters to scope the search.
Pagination is offset-based; the response omits a total count. Detect end-of-results when `data.length < limit`.
Read a recipe''s `composition` and `blocks` via GET /recipes/{slug}; fetch each block''s spec via GET /blocks/{slug}.'
operationId: getApiV1Recipes
x-operation-id-source: derived
/api/v1/recipes/{slug}:
get:
parameters:
- in: path
name: slug
required: true
schema:
type: string
description: The recipe's kebab-case slug, from a previous search hit.
- in: query
name: view
required: false
schema:
default: full
type: string
enum:
- summary
- outline
- full
description: 'Response detail: summary | outline | full. Default full.'
responses:
'200':
description: The recipe.
content:
application/json:
schema:
title: Recipe
description: A composition of blocks — a section or page to reference and rebuild from.
type: object
properties:
slug:
description: URL-safe handle, unique within its kind.
type: string
kind:
description: Recipe kind.
type: string
title:
description: Human-readable display name.
type: string
description:
description: Tagline plus 1–2 prose sentences.
type: string
blocks:
description: Block slugs this recipe composes. Fetch each via GET /blocks/{slug}.
type: array
items:
type: string
composition:
description: The arrangement to reference — `{mode, tree}` for `view=full`, `{mode, ops}` for `view=outline`. Absent for `view=summary`, which does not read it. A pattern to build something similar from, not a verbatim stamp.
type: object
additionalProperties: {}
family:
description: Variant family, e.g. `header`.
type: string
category:
description: Broader bucket, e.g. `marketing`.
type: string
required:
- slug
- kind
- title
- description
- blocks
additionalProperties: false
'404':
description: No recipe matches the slug.
content:
application/json:
schema:
type: object
properties: {}
additionalProperties: false
tags:
- Recipes
summary: Get one recipe
description: Reads the full recipe for the slug in the path — the `blocks` it composes (fetch each via GET /blocks/{slug}) and `composition`, the arrangement to reference and build something similar from (not a verbatim stamp).
operationId: getApiV1RecipesBySlug
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: opaque
description: 'An Orbit api token, sent as `Authorization: Bearer <token>`.
Mint one with the RFC 8628 device-authorization grant (`POST /api/v1/device/code`, then poll `POST /api/v1/device/token`), or from Studio.
Every token carries a scope set from the `[verb resource]` RBAC catalog — `read:app`, `write:deployment`, `manage:secret`, and so on. The full vocabulary is published as `scopes_supported` at `/.well-known/oauth-protected-resource` (RFC 9728) and `/.well-known/oauth-authorization-server` (RFC 8414). Grant an agent the narrowest set that does its job.'
externalDocs:
description: Full documentation
url: https://docs.orbitapps.io
x-id:
- reitit.openapi/default