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

Package release publishing and management.

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

This API exposes 5 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.

5 operations 3 paths 3 schemas 2 DELETE1 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 Releases 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 5

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

Releases 5

Package release publishing and management.

GET
/packages/{name}/releases/{version}
Fetch a Release
getRelease 2 params → 200404
DELETE
/packages/{name}/releases/{version}
Revert a Release
revertRelease 2 params → 204403404
POST
/publish
Publish a Release
publishRelease body → 201400422
POST
/packages/{name}/releases/{version}/retire
Mark Release as Retired
retireRelease 2 params body → 204404
DELETE
/packages/{name}/releases/{version}/retire
Unmark Release as Retired
unretireRelease 2 params → 204404

Schemas 3

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

Release
object
13 properties
RetireRelease
object
2 properties 1 required
Error
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Hex.pm publishes across the network.

Hex.pm API Keys API
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 Repositories API
Hex.pm Users API
Hex.pm Utilities API