Orbit Recipes API

Recipe compositions — reusable sections and pages built from blocks

GitHub OpenAPI

Operations 2

GET /api/v1/recipes Search and browse reusable recipes #
GET /api/v1/recipes/{slug} Get one recipe #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/orbitapps-io:orbitapps-io-recipes-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

orbitapps-io-recipes-api-openapi.yml Raw ↑
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