Skip to main content
The CLI provides commands for interacting with your mock APIs in WireMock Cloud.

Listing Mock APIs

You can list your mock APIs using:
This will display your mock APIs in a human-readable text format. By default, it shows up to 20 results on the first page.

Options

The list command supports several options to customize the output:
  • --limit=<int> - Set the maximum number of mock APIs to return (default: 20)
  • --page=<int> - Select which page of results to show (default: 1)
  • --query=<text> - Filter mock APIs using a search query
  • -o, --output=(text|json) - Choose between text or JSON output format (default: text)

Examples

List first 5 mock APIs:
Search for mock APIs containing “test”:
Get results in JSON format:

Creating Mock APIs

You can create a new mock API using:
This will create a new mock API with the given name.

Options

The create command supports the following options:
  • -o, --hostname=<text> - Optional custom hostname for the mock API
  • -t, --type=(REST|Unstructured|gRPC|GraphQL) - Type of the mock API (default: REST)

Examples

Create a new mock API called NewName
Create a new mock API of type GraphQL
Create a new mock API of type Unstructured with a custom hostname

Delete a mock API

You can delete a new mock API using:
This will delete the mock API with the given ID. By default, it will prompt you for confirmation before deleting the mock API.

Options

The delete command supports the following options:
  • -f, --force - Force delete the mock API without confirmation

Examples

Delete a mock API with ID v16kg
Force delete a mock API with ID v16kg