API Specs

List the versions of a specification

Returns the versions of a specification with their status and publish target. Only a version whose status is published is frozen, so anything else can still change underneath you.

get/api/projects/{projectId}/specs/{specId}/versions

Request

  • Base URL: https://api.routebase.dev
  • URL: https://api.routebase.dev/api/projects/{projectId}/specs/{specId}/versions
  • Auth: API key in header X-API-Key

Path parameters

ProjectIdstring uuid required

Public id of the project.

SpecIdstring uuid required

Public id of the API specification.

Query parameters

Skipinteger

Number of items to skip. Defaults to 0.

Takeinteger

Maximum number of items to return.

Headers

X-RB-Regionstring
Example:us

Region of your organization. US organizations must send us; EU organizations leave the header out. Without it a US call is routed to the EU region and answered with 401.

Response

A page of versions.

totalCountinteger required

Total number of versions of this specification, ignoring paging.

Changes

No recorded changes to this operation across all 1 revision of this API.