Method: projects.locations.apis.versions.specs.listRevisions

Lists all revisions of a spec. Revisions are returned in descending order of revision creation time.

HTTP request

GET https://apigeeregistry.googleapis.com/v1/{name=projects/*/locations/*/apis/*/versions/*/specs/*}:listRevisions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the spec to list revisions for.

Query parameters

Parameters
pageSize

integer

The maximum number of revisions to return per page.

pageToken

string

The page token, received from a previous specs.listRevisions call. Provide this to retrieve the subsequent page.

filter

string

An expression that can be used to filter the list. Filters use the Common Expression Language and can refer to all message fields.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for ListApiSpecRevisionsResponse.

JSON representation
{
  "apiSpecs": [
    {
      object (ApiSpec)
    }
  ],
  "nextPageToken": string
}
Fields
apiSpecs[]

object (ApiSpec)

The revisions of the spec.

nextPageToken

string

A token that can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform