EditalMD Account API

The Account API from EditalMD — 7 operation(s) for account.

GitHub OpenAPI

Operations 7

GET /api/account/profile Reads your global profile #
GET /api/account/avatar Gets your global profile photo #
GET /api/account/keys Lists your API keys in this product #
POST /api/account/keys/create Creates an API key for agents and scripts #
POST /api/account/keys/revoke Revokes one of your API keys #
GET /api/account/apps Lists the apps connected to your account in this product #
POST /api/account/apps/revoke Disconnects an app from your account #

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/editalmd:editalmd-account-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. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

editalmd-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: EditalMD Account API
  version: 1d751aaf
servers:
- url: https://editalmd.com
tags:
- name: Account
paths:
  /api/account/profile:
    get:
      operationId: get_api_account_profile
      summary: Reads your global profile
      description: 'Reads the current preferences of the account. Change them on the account page; products keep no separate authoritative profile.

        Returns: {profile:{name,locale,timeZone,theme,revision}}'
      responses:
        '200':
          description: '{profile:{name,locale,timeZone,theme,revision}}'
        '401':
          description: invalid_session
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
  /api/account/avatar:
    get:
      operationId: get_api_account_avatar
      summary: Gets your global profile photo
      description: 'Private WebP of up to 64 KiB, without cache. Change it in the account. It does not accept a user ID or an object URL.

        Returns: image/webp; Cache-Control: no-store'
      responses:
        '200':
          description: 'image/webp; Cache-Control: no-store'
          content:
            image/webp:
              schema:
                type: string
                format: binary
        '401':
          description: invalid_session
        '404':
          description: 'not_found: no photo'
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
  /api/account/keys:
    get:
      operationId: get_api_account_keys
      summary: Lists your API keys in this product
      description: 'Never returns the key: name, last 4 characters, organization, creation, last use (per hour) and whether it is still valid.

        Returns: { keys }'
      responses:
        '200':
          description: '{ keys }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  keys:
                    type: array
                    items:
                      type: object
                    description: '`id`, `name`, `organizationId`, `last4`, `createdAt`, `lastUsedAt`, `revokedAt`, `active` (false when revoked, or stopped by a password change or by ending all sessions).'
                required:
                - keys
        '401':
          description: invalid_session
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
  /api/account/keys/create:
    post:
      operationId: post_api_account_keys_create
      summary: Creates an API key for agents and scripts
      description: 'Requires a sign-in in the last 5 minutes; an organization key also requires a second factor in the session and the owner or administrator role with the product enabled. At most 10 live keys per account and product. The key (`secret`) comes back ONCE.

        Returns: { key, secret }'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Up to 60 characters.
                organizationId:
                  type:
                  - string
                  - 'null'
                  description: '`null` for an account key.'
              required:
              - name
              - organizationId
            example:
              name: agent
              organizationId: null
      responses:
        '200':
          description: '{ key, secret }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  key:
                    type: object
                    description: '`id`, `name`, `organizationId`, `last4`, `createdAt`.'
                  secret:
                    type: string
                    description: '`mmk_…`, shown once.'
                required:
                - key
                - secret
        '400':
          description: invalid_key_name / invalid_organization
        '401':
          description: invalid_session / reauth_required
        '403':
          description: invalid_origin / invalid_csrf / organization_forbidden / organization_mfa_required
        '409':
          description: key_limit_reached
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
  /api/account/keys/revoke:
    post:
      operationId: post_api_account_keys_revoke
      summary: Revokes one of your API keys
      description: 'Stops the key immediately. Repeating does no harm.

        Returns: { ok }'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  description: The `id` of the key.
              required:
              - id
            example:
              id: …
      responses:
        '200':
          description: '{ ok }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    description: 'true'
                required:
                - ok
        '400':
          description: invalid_key_id
        '401':
          description: invalid_session
        '403':
          description: invalid_origin / invalid_csrf
        '404':
          description: key_not_found
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
  /api/account/apps:
    get:
      operationId: get_api_account_apps
      summary: Lists the apps connected to your account in this product
      description: 'The MCP clients you signed in with (OAuth), such as claude.ai or ChatGPT. Never returns a token.

        Returns: { apps }'
      responses:
        '200':
          description: '{ apps }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  apps:
                    type: array
                    items:
                      type: object
                    description: 'Up to 50: `id`, `nome` (the app; its host when it identifies itself by a metadata document), `criadoEm`, `usadoEm` (per hour, or null).'
                required:
                - apps
        '401':
          description: invalid_session
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
  /api/account/apps/revoke:
    post:
      operationId: post_api_account_apps_revoke
      summary: Disconnects an app from your account
      description: 'Stops the app''s access at once; it asks you to sign in again. Repeating does no harm.

        Returns: { ok }'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  description: The `id` of the app.
              required:
              - id
            example:
              id: …
      responses:
        '200':
          description: '{ ok }'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    description: 'true'
                required:
                - ok
        '400':
          description: invalid_app_id
        '401':
          description: invalid_session
        '403':
          description: invalid_origin / invalid_csrf
        '404':
          description: app_not_found
        '503':
          description: auth_unavailable
      security:
      - globalAccount: []
      tags:
      - Account
components:
  securitySchemes:
    globalAccount:
      type: apiKey
      in: cookie
      name: __Host-mm-auth
      description: Global session in the product's HttpOnly cookie; writes require exact Origin and X-CSRF-Token.
    contaChaveApi:
      type: http
      scheme: bearer
      bearerFormat: mmk_…
      description: 'Account API key: `Authorization: Bearer mmk_…` or `X-Api-Key: mmk_…`. Created on the account page (API keys), valid only in the product where it was created; it acts as the account (or the organization that owns it).'
    carteiraAgente:
      type: http
      scheme: bearer
      bearerFormat: mmw_…
      description: 'Wallet credential of an agent without an account (`Authorization: Bearer mmw_…`, 30 days, this product only): POST /api/auth/wallet/agent/start, sign the message with the wallet, POST /api/auth/wallet/agent/token. The owner is `x402:<address>`.'
x-service-info:
  categories:
  - public-procurement
  - documents
  - data
  docs:
    homepage: https://editalmd.com/
    apiReference: https://editalmd.com/developers
    llms: https://editalmd.com/llms.txt