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 Documentation API

HexDocs package documentation.

Hex.pm Documentation 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 Documentation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 3 operations across 1 path, and defines 1 schema. 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.

3 operations 1 paths 1 schemas 1 DELETE1 GET1 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 Documentation 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 3

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

Documentation 3

HexDocs package documentation.

GET
/packages/{name}/releases/{version}/docs
Get Package Documentation
getPackageDocs 2 params → 200404
POST
/packages/{name}/releases/{version}/docs
Publish Package Documentation
publishPackageDocs 2 params body → 201422
DELETE
/packages/{name}/releases/{version}/docs
Remove Package Documentation
removePackageDocs 2 params → 204404

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Error (3 properties). Each schema is shown below with its type and property counts.

Error
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Hex.pm publishes across the network.

Hex.pm API Keys API
Hex.pm Authentication 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