Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hex.pm API Keys API

API key creation and management.

Hex.pm API Keys API is one of 12 APIs that Hex.pm publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include API Keys. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 7 operations across 3 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://hex.pm/api.

7 operations 3 paths 3 schemas 2 DELETE3 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://hex.pm/api
Authentication
API Key, HTTP Bearer, HTTP Basic
Terms of Service
Resource Areas
1

Authentication & Security 3

Hex.pm API Keys API declares 3 security schemes for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). It accepts HTTP bearer tokens (BearerAuth). It accepts HTTP basic authentication (BasicAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API token authentication. Pass the token directly: Authorization: token. For OAuth2 Bearer tokens use: Authorization: Bearer token.
  • BearerAuth — OAuth2 Bearer token obtained via Device Authorization Grant (RFC 8628).
  • BasicAuth — Deprecated. Basic authentication with username and password. Only allowed on specific endpoints for generating API tokens.

Paths & Operations 7

Across 3 paths, the API surfaces 7 operations — 2 DELETE, 3 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

API Keys 7

API key creation and management.

GET
/keys
List all API Keys
listApiKeys → 200
POST
/keys
Create an API Key
createApiKey body → 201422
DELETE
/keys
Remove all API Keys
removeAllApiKeys → 204
GET
/keys/{name}
Fetch an API Key
getApiKey 1 param → 200404
DELETE
/keys/{name}
Remove an API Key
removeApiKey 1 param → 200404
GET
/orgs/{name}/keys
List Organization API Keys
listOrganizationApiKeys 1 param → 200
POST
/orgs/{name}/keys
Create Organization API Key
createOrganizationApiKey 1 param body → 201422

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are ApiKey (7 properties), Error (3 properties), ApiKeyCreate (2 properties). Each schema is shown below with its type and property counts.

ApiKeyCreate
object
2 properties 2 required
ApiKey
object
7 properties
Error
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hex-pm-api-keys-api-openapi.yml Raw ↑

Other APIs Hex.pm publishes across the network.

Hex.pm Authentication API
Hex.pm Documentation API
Hex.pm Index API
Hex.pm OAuth API
Hex.pm Organizations API
Hex.pm Package Owners API
Hex.pm Packages API
Hex.pm Releases API
Hex.pm Repositories API
Hex.pm Users API
Hex.pm Utilities API