Maginary Profiles API

The profiles API from Maginary — 6 operation(s) for profiles.

GitHub OpenAPI

Operations 8

GET /profiles/me/ Get or update authenticated user's profile #
PUT /profiles/me/ Get or update authenticated user's profile #
PATCH /profiles/me/ Get or update authenticated user's profile #
POST /profiles/me/toggle-privacy/ Toggle profile privacy setting #
POST /profiles/upload-avatar/ Upload profile avatar image #
GET /profiles/{username}/ Get profile by username #
GET /profiles/{username}/generations/ Profiles generations #
GET /profiles/{username}/recipes/ Get user's public recipes #

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-profiles-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-profiles-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Maginary Profiles 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: Profiles
paths:
  /profiles/me/:
    parameters: []
    get:
      operationId: profiles_me_read
      summary: Get or update authenticated user's profile
      description: 'GET /api/profiles/me/ - Retrieve own profile

        PATCH /api/profiles/me/ - Partial update own profile

        PUT /api/profiles/me/ - Full update own profile'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
    put:
      operationId: profiles_me_update
      summary: Get or update authenticated user's profile
      description: 'GET /api/profiles/me/ - Retrieve own profile

        PATCH /api/profiles/me/ - Partial update own profile

        PUT /api/profiles/me/ - Full update own profile'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserProfilePublic'
        required: true
    patch:
      operationId: profiles_me_partial_update
      summary: Get or update authenticated user's profile
      description: 'GET /api/profiles/me/ - Retrieve own profile

        PATCH /api/profiles/me/ - Partial update own profile

        PUT /api/profiles/me/ - Full update own profile'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserProfilePublic'
        required: true
  /profiles/me/toggle-privacy/:
    parameters: []
    post:
      operationId: profiles_me_toggle_privacy
      summary: Toggle profile privacy setting
      description: POST /api/profiles/me/toggle-privacy/
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserProfilePublic'
        required: true
  /profiles/upload-avatar/:
    parameters: []
    post:
      operationId: profiles_upload_avatar
      summary: Upload profile avatar image
      description: POST /api/profiles/upload-avatar/
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserProfilePublic'
        required: true
  /profiles/{username}/:
    parameters:
    - name: username
      in: path
      required: true
      schema:
        type: string
        pattern: '[a-zA-Z0-9_-]+'
    get:
      operationId: profiles_read
      summary: Get profile by username
      description: 'Handles both public and non-public profiles:

        - Public profiles: Full data

        - Non-public profiles: Minimal data (username, display_name, avatar)

        - Own profile: Full data regardless of is_public setting


        Rate limits: 60/min per user, 180/min per IP'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
  /profiles/{username}/generations/:
    parameters:
    - name: username
      in: path
      required: true
      schema:
        type: string
        pattern: '[a-zA-Z0-9_-]+'
    get:
      operationId: profiles_generations
      description: Get user's public generations (with slugs).
      parameters:
      - name: search
        in: query
        description: Search prompt, slug, SEO title/description
        required: false
        schema:
          type: string
      - name: limit
        in: query
        description: Max results (default 12, max 50)
        required: false
        schema:
          type: integer
      - name: offset
        in: query
        description: Pagination offset
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
      summary: Profiles generations
      x-summary-source: derived
  /profiles/{username}/recipes/:
    parameters:
    - name: username
      in: path
      required: true
      schema:
        type: string
        pattern: '[a-zA-Z0-9_-]+'
    get:
      operationId: profiles_recipes
      summary: Get user's public recipes
      description: 'GET /api/profiles/{username}/recipes/


        Returns public recipes created by this user.

        Respects show_created_recipes and is_public privacy settings.


        Rate limits: 60/min per user, 180/min per IP'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfilePublic'
      tags:
      - Profiles
components:
  schemas:
    UserProfilePublic:
      type: object
      properties:
        username:
          title: Username
          description: Public-facing username for profile URL (auto-generated from User2.username)
          type: string
          readOnly: true
          minLength: 1
        display_name:
          title: Display name
          description: Display name shown on profile (defaults to username if empty)
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        bio:
          title: Bio
          description: Short bio/description for profile page
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        avatar_url:
          title: Avatar url
          type: string
          readOnly: true
        website_url:
          title: Website url
          description: Personal website URL
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        is_public:
          title: Is public
          description: Whether profile is publicly visible (for SEO indexing)
          type: boolean
          readOnly: true
        total_generations:
          title: Total generations
          type: string
          readOnly: true
        recipes_created:
          title: Recipes created
          type: string
          readOnly: true
        twitter_username:
          title: Twitter username
          description: Twitter/X username (without @)
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        instagram_username:
          title: Instagram username
          description: Instagram username (without @)
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        tiktok_username:
          title: Tiktok username
          description: TikTok username (without @)
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        youtube_channel:
          title: Youtube channel
          description: YouTube channel ID or handle
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        buymeacoffee_username:
          title: Buymeacoffee username
          description: Buy Me a Coffee username (for donation links)
          type:
          - string
          - 'null'
          readOnly: true
          minLength: 1
        paypal_email:
          title: Paypal email
          description: PayPal email for donation links
          type:
          - string
          - 'null'
          format: email
          readOnly: true
          minLength: 1
        seo_title:
          title: Seo title
          type: string
          readOnly: true
        seo_description:
          title: Seo description
          type: string
          readOnly: true
        created_at:
          title: Created at
          type: string
          format: date-time
          readOnly: true
        user_date_joined:
          title: User date joined
          type: string
          format: date-time
          readOnly: true
  securitySchemes:
    Basic:
      type: http
      scheme: basic
    Bearer:
      type: apiKey
      name: Authorization
      in: header