Maginary Recipes API

The recipes API from Maginary — 12 operation(s) for recipes.

GitHub OpenAPI

Operations 15

GET /recipes/ Recipes list #
POST /recipes/ Recipes create #
GET /recipes/favorites/ Get current user's favorited recipes #
GET /recipes/my/ Recipes my recipes #
GET /recipes/{uuid}/ Get recipe detail by UUID or slug with visibility check #
PUT /recipes/{uuid}/ Recipes update #
DELETE /recipes/{uuid}/ Recipes delete #
POST /recipes/{uuid}/bake/ Bake a recipe: assemble prompt + optionally check credits #
POST /recipes/{uuid}/comment/ Add a comment to a recipe #
GET /recipes/{uuid}/comments/ Get comments for a recipe #
POST /recipes/{uuid}/favorite/ Toggle favorite for a recipe #
POST /recipes/{uuid}/steal/ Copy/steal a recipe (creates a new recipe owned by current user) #
POST /recipes/{uuid}/use/ Use a recipe to create a Gen (convenience endpoint: bake + create Gen) #

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/maginary-ai:maginary-ai-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

maginary-ai-recipes-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Maginary Recipes API
  description: Public API documentation for Maginary — AI image and video generation platform.
  version: v1
servers:
- url: https://app.maginary.ai/api
security:
- Basic: []
- Bearer: []
tags:
- name: recipes
paths:
  /recipes/:
    parameters: []
    get:
      operationId: recipes_list
      description: List public recipes with optional filtering.
      parameters:
      - name: visibility
        in: query
        description: Filter by visibility (e.g., 'public')
        required: false
        schema:
          type: string
      - name: search
        in: query
        description: Search by title, description, or tags
        required: false
        schema:
          type: string
      - name: category
        in: query
        description: Filter by category
        required: false
        schema:
          type: string
      - name: tags
        in: query
        description: Filter by tags (comma-separated)
        required: false
        schema:
          type: string
      - name: event
        in: query
        description: Filter by event type
        required: false
        schema:
          type: string
      - name: order
        in: query
        description: 'Sort order: -use_count, -created_at, title'
        required: false
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RecipeList'
      tags:
      - recipes
      summary: Recipes list
      x-summary-source: derived
    post:
      operationId: recipes_create
      description: Create new recipe (authenticated users only)
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeCreate'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeCreate'
        required: true
      summary: Recipes create
      x-summary-source: derived
  /recipes/favorites/:
    parameters: []
    get:
      operationId: recipes_favorites_list
      summary: Get current user's favorited recipes
      description: GET /api/recipes/favorites/
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
  /recipes/featured/:
    parameters: []
    get:
      operationId: recipes_featured
      description: Get featured recipes (public, no auth required)
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
      summary: Recipes featured
      x-summary-source: derived
  /recipes/my/:
    parameters: []
    get:
      operationId: recipes_my_recipes
      description: Get current user's recipes
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
      summary: Recipes my recipes
      x-summary-source: derived
  /recipes/trending/:
    parameters: []
    get:
      operationId: recipes_trending
      summary: Get trending recipes (public, sorted by engagement score)
      description: Score = use_count + (favorite_count * 2) + (steal_count * 3) + (comment_count * 1.5)
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
  /recipes/{uuid}/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: recipes_read
      summary: Get recipe detail by UUID or slug with visibility check
      description: Allows unlisted recipes to be accessed via direct link.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
    put:
      operationId: recipes_update
      description: Update recipe (owner only)
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeUpdate'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeUpdate'
        required: true
      summary: Recipes update
      x-summary-source: derived
    delete:
      operationId: recipes_delete
      description: Delete recipe (owner only)
      responses:
        '204':
          description: ''
      tags:
      - recipes
      summary: Recipes delete
      x-summary-source: derived
  /recipes/{uuid}/bake/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: recipes_bake
      summary: 'Bake a recipe: assemble prompt + optionally check credits'
      description: 'Respects source visibility - only returns prompt if user can see source.

        Optionally performs credit check without revealing prompt.


        POST /recipes/{uuid}/bake/

        {

        "field_values": [

        {"field_id": "photo", "value": "https://..."},

        {"field_id": "background", "value": "office"}

        ],

        "check_credits": false // Optional, default false

        }


        Returns (when check_credits=false):

        {

        "prompt": "assembled prompt" // null if !can_see_source

        }


        Returns (when check_credits=true):

        {

        "prompt": "assembled prompt", // null if !can_see_source

        "credits": 10,

        "error": null // or error message if check fails

        }'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeDetail'
        required: true
  /recipes/{uuid}/comment/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: recipes_comment
      summary: Add a comment to a recipe
      description: 'POST /recipes/{uuid}/comment/

        {

        "text": "Great recipe!"

        }


        Returns the created comment.'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeDetail'
        required: true
  /recipes/{uuid}/comments/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: recipes_comments_list
      summary: Get comments for a recipe
      description: GET /recipes/{uuid}/comments/
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
  /recipes/{uuid}/favorite/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: recipes_favorite
      summary: Toggle favorite for a recipe
      description: POST /recipes/{uuid}/favorite/
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeDetail'
        required: true
  /recipes/{uuid}/steal/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: recipes_steal
      summary: Copy/steal a recipe (creates a new recipe owned by current user)
      description: 'Requires can_duplicate permission (user must be able to see source).


        POST /recipes/{uuid}/steal/


        Returns the newly created recipe.'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeDetail'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeDetail'
        required: true
  /recipes/{uuid}/use/:
    parameters:
    - name: uuid
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: recipes_use
      summary: 'Use a recipe to create a Gen (convenience endpoint: bake + create Gen)'
      description: 'Requires can_use permission.


        POST /recipes/{uuid}/use/

        {

        "field_values": [

        {"field_id": "photo", "value": "https://..."},

        {"field_id": "background", "value": "office"}

        ]

        }


        Returns full Gen object (same format as POST /api/gens/).'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeUse'
      tags:
      - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeUse'
        required: true
components:
  schemas:
    RecipeFieldValue:
      description: Values for schema fields (required for schema-based recipes)
      required:
      - field_id
      - value
      type: object
      properties:
        field_id:
          title: Field id
          description: ID of the field from schema
          type: string
          minLength: 1
        value:
          title: Value
          description: User-provided value for this field
          type: object
    RecipeUse:
      type: object
      properties:
        field_values:
          description: Values for schema fields (required for schema-based recipes)
          type: array
          items:
            $ref: '#/components/schemas/RecipeFieldValue'
    RecipeUpdate:
      required:
      - title
      type: object
      properties:
        title:
          title: Title
          description: Recipe title
          type: string
          maxLength: 200
          minLength: 1
        description:
          title: Description
          description: What this recipe creates
          type: string
        image_url:
          title: Image url
          description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
          type: string
          format: uri
          maxLength: 500
        slug:
          title: Slug
          description: URL-friendly slug
          type: string
          format: slug
          pattern: ^[-a-zA-Z0-9_]+$
          maxLength: 200
        schema_json:
          title: Schema json
          description: JSON schema defining fields and prompt template (null = simple prompt recipe)
          type:
          - object
          - 'null'
        field_values:
          title: Field values
          description: Default values for schema fields
          type: object
        prompt:
          title: Prompt
          description: Simple prompt template (used if schema_json is null)
          type: string
        parameters:
          title: Parameters
          description: Simple parameters (used if schema_json is null)
          type: object
        category:
          title: Category
          description: Recipe category for filtering
          type: string
          enum:
          - portrait
          - product
          - holiday
          - location
          - professional
          - creative
          - other
        tags:
          title: Tags
          description: Searchable tags (e.g., ["linkedin", "professional"])
          type: object
        visibility:
          title: Visibility
          description: Visibility and source access level
          type: string
          enum:
          - private
          - unlisted_use
          - unlisted_full
          - public_use
          - public_full
        is_public:
          title: Is public
          description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
          type: boolean
        event_type:
          title: Event type
          description: Associated holiday/event (for seasonal recipes)
          type:
          - string
          - 'null'
          enum:
          - diwali
          - christmas
          - halloween
          - new_year
          - valentines
          - easter
          - thanksgiving
          - holi
          - lunar_new_year
          - ramadan
          - custom
          - null
        event_start_date:
          title: Event start date
          description: When to start showing this event recipe
          type:
          - string
          - 'null'
          format: date
        event_end_date:
          title: Event end date
          description: When to stop showing this event recipe
          type:
          - string
          - 'null'
          format: date
        seo_title:
          title: Seo title
          description: Custom SEO title (max 60 chars)
          type:
          - string
          - 'null'
          maxLength: 60
        seo_description:
          title: Seo description
          description: Custom SEO description (max 160 chars)
          type:
          - string
          - 'null'
          maxLength: 160
        seo_image:
          title: Seo image
          description: SEO/Open Graph image URL (for social media previews)
          type:
          - string
          - 'null'
          format: uri
          maxLength: 500
        example_images:
          title: Example images
          description: List of example image URLs with metadata
          type: object
    RecipeList:
      type: object
      properties:
        uuid:
          title: Uuid
          description: Unique identifier for URLs
          type: string
          readOnly: true
          minLength: 1
        slug:
          title: Slug
          description: URL-friendly slug
          type: string
          format: slug
          pattern: ^[-a-zA-Z0-9_]+$
          readOnly: true
          minLength: 1
        title:
          title: Title
          description: Recipe title
          type: string
          readOnly: true
          minLength: 1
        description:
          title: Description
          description: What this recipe creates
          type: string
          readOnly: true
          minLength: 1
        image_url:
          title: Image url
          description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
          type: string
          format: uri
          readOnly: true
          minLength: 1
        category:
          title: Category
          description: Recipe category for filtering
          type: string
          enum:
          - portrait
          - product
          - holiday
          - location
          - professional
          - creative
          - other
          readOnly: true
        tags:
          title: Tags
          description: Searchable tags (e.g., ["linkedin", "professional"])
          type: object
          readOnly: true
        is_official:
          title: Is official
          description: Official/curated recipe (staff-created)
          type: boolean
          readOnly: true
        visibility:
          title: Visibility
          description: Visibility and source access level
          type: string
          enum:
          - private
          - unlisted_use
          - unlisted_full
          - public_use
          - public_full
          readOnly: true
        is_public:
          title: Is public
          description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
          type: boolean
          readOnly: true
        is_featured:
          title: Is featured
          description: Featured on landing page
          type: boolean
          readOnly: true
        event_type:
          title: Event type
          description: Associated holiday/event (for seasonal recipes)
          type:
          - string
          - 'null'
          enum:
          - diwali
          - christmas
          - halloween
          - new_year
          - valentines
          - easter
          - thanksgiving
          - holi
          - lunar_new_year
          - ramadan
          - custom
          - null
          readOnly: true
        use_count:
          title: Use count
          description: Number of times this recipe has been used
          type: integer
          readOnly: true
        steal_count:
          title: Steal count
          description: Number of times this recipe has been copied
          type: integer
          readOnly: true
        favorite_count:
          title: Favorite count
          description: Number of favorites
          type: integer
          readOnly: true
        comment_count:
          title: Comment count
          description: Number of comments
          type: integer
          readOnly: true
        example_images:
          title: Example images
          description: List of example image URLs with metadata
          type: object
          readOnly: true
        created_by_username:
          title: Created by username
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        created_at:
          title: Created at
          type: string
          format: date-time
          readOnly: true
    RecipeDetail:
      required:
      - title
      type: object
      properties:
        uuid:
          title: Uuid
          description: Unique identifier for URLs
          type: string
          readOnly: true
          minLength: 1
        slug:
          title: Slug
          description: URL-friendly slug
          type: string
          format: slug
          pattern: ^[-a-zA-Z0-9_]+$
          readOnly: true
          minLength: 1
        version:
          title: Version
          description: Version number, increments on each edit (for tracking recipe changes)
          type: integer
          readOnly: true
        title:
          title: Title
          description: Recipe title
          type: string
          maxLength: 200
          minLength: 1
        description:
          title: Description
          description: What this recipe creates
          type: string
        image_url:
          title: Image url
          description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
          type: string
          format: uri
          maxLength: 500
        schema_json:
          title: Schema json
          description: JSON schema defining fields and prompt template (null = simple prompt recipe)
          type:
          - object
          - 'null'
        field_values:
          title: Field values
          description: Default values for schema fields
          type: object
        prompt:
          title: Prompt
          description: Simple prompt template (used if schema_json is null)
          type: string
        parameters:
          title: Parameters
          description: Simple parameters (used if schema_json is null)
          type: object
        category:
          title: Category
          description: Recipe category for filtering
          type: string
          enum:
          - portrait
          - product
          - holiday
          - location
          - professional
          - creative
          - other
        tags:
          title: Tags
          description: Searchable tags (e.g., ["linkedin", "professional"])
          type: object
        is_official:
          title: Is official
          description: Official/curated recipe (staff-created)
          type: boolean
        visibility:
          title: Visibility
          description: Visibility and source access level
          type: string
          enum:
          - private
          - unlisted_use
          - unlisted_full
          - public_use
          - public_full
        is_public:
          title: Is public
          description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
          type: boolean
        is_featured:
          title: Is featured
          description: Featured on landing page
          type: boolean
        event_type:
          title: Event type
          description: Associated holiday/event (for seasonal recipes)
          type:
          - string
          - 'null'
          enum:
          - diwali
          - christmas
          - halloween
          - new_year
          - valentines
          - easter
          - thanksgiving
          - holi
          - lunar_new_year
          - ramadan
          - custom
          - null
        event_start_date:
          title: Event start date
          description: When to start showing this event recipe
          type:
          - string
          - 'null'
          format: date
        event_end_date:
          title: Event end date
          description: When to stop showing this event recipe
          type:
          - string
          - 'null'
          format: date
        seo_title:
          title: Seo title
          description: Custom SEO title (max 60 chars)
          type:
          - string
          - 'null'
          maxLength: 60
        seo_description:
          title: Seo description
          description: Custom SEO description (max 160 chars)
          type:
          - string
          - 'null'
          maxLength: 160
        seo_image:
          title: Seo image
          description: SEO/Open Graph image URL (for social media previews)
          type:
          - string
          - 'null'
          format: uri
          maxLength: 500
        use_count:
          title: Use count
          description: Number of times this recipe has been used
          type: integer
          readOnly: true
        favorite_count:
          title: Favorite count
          description: Number of favorites
          type: integer
          maximum: 9223372036854775807
          minimum: 0
        example_images:
          title: Example images
          description: List of example image URLs with metadata
          type: object
        created_by_username:
          title: Created by username
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        created_by:
          title: Created by
          type:
          - integer
          - 'null'
          readOnly: true
        is_schema_based:
          title: Is schema based
          type: boolean
          readOnly: true
        favorited:
          title: Favorited
          type: string
          readOnly: true
        can_see_source:
          title: Can see source
          type: string
          readOnly: true
        can_duplicate:
          title: Can duplicate
          type: string
          readOnly: true
        community_generations:
          type: array
          items:
            type: string
          readOnly: true
        community_generations_total:
          title: Community generations total
          type: integer
          readOnly: true
        created_at:
          title: Created at
          type: string
          format: date-time
          readOnly: true
        updated_at:
          title: Updated at
          type: string
          format: date-time
          readOnly: true
    RecipeCreate:
      required:
      - title
      type: object
      properties:
        title:
          title: Title
          description: Recipe title
          type: string
          maxLength: 200
          minLength: 1
        description:
          title: Description
          description: What this recipe creates
          type: string
        image_url:
          title: Image url
          description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
          type: string
          format: uri
          maxLength: 500
        schema_json:
          title: Schema json
          description: JSON schema defining fields and prompt template (null = simple prompt recipe)
          type:
          - object
          - 'null'
        field_values:
          title: Field values
          description: Default values for schema fields
          type: object
        prompt:
          title: Prompt
          description: Simple prompt template (used if schema_json is null)
          type: string
        parameters:
          title: Parameters
          description: Simple parameters (used if schema_json is null)
          type: object
        category:
          title: Category
          description: Recipe category for filtering
          type: string
          enum:
          - portrait
          - product
          - holiday
          - location
          - professional
          - creative
          - other
        tags:
          title: Tags
          description: Searchable tags (e.g., ["linkedin", "professional"])
          type: object
        visibility:
          title: Visibility
          description: Visibility and source access level
          type: string
          enum:
          - private
          - unlisted_use
          - unlisted_full
          - public_use
          - public_full
        is_public:
          title: Is public
          description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
          type: boolean
        event_type:
          title: Event type
          description: Associated holiday/event (for seasonal recipes)
          type:
          - string
          - 'null'
          enum:
          - diwali
          - christmas
          - halloween
          - new_year
          - valentines
          - easter
          - thanksgiving
          - holi
          - lunar_new_year
          - ramadan
          - custom
          - null
        event_start_date:
          title: Event start date
          description: When to start showing this event recipe
          type:
          - string
          - 'null'
          format: date
        event_end_date:
          title: Event end date
          description: When to stop showing this event recipe
          type:
          - string
          - 'null'
          format: date
        seo_title:
          title: Seo title
          description: Custom SEO title (max 60 chars)
          type:
          - string
          - 'null'
          maxLength: 60
        seo_description:
          title: Seo description
          description: Custom SEO description (max 160 chars)
          type:
          - string
          - 'null'
          maxLength: 160
        seo_image:
          title: Seo image
          description: SEO/Open Graph image URL (for social media previews)
          type:
          - string
          - 'null'
          format: uri
          maxLength: 500
        example_images:
          title: Example images
          description: List of example image URLs with metadata
          type: object
  securitySchemes:
    Basic:
      type: http
      scheme: basic
    Bearer:
      type: apiKey
      name: Authorization
      in: header