API & Collection CLI Commands Reference

Collection Commands

maeris collection list

Lists all collections in the current application.

maeris collection list

maeris collection create

Creates a new collection. Use --parent to create a sub-collection.

maeris collection create "My API Collection" maeris collection create "Authentication" --parent "My API Collection"

maeris collection get

Retrieves details of a specific collection including API count, environment, and last modified date.

maeris collection get "My API Collection"

maeris collection clone

Creates a full copy of a collection with all its APIs.

maeris collection clone "My API Collection" "My API Collection (Staging)"

maeris collection rename

Renames an existing collection.

maeris collection rename "Old Name" "New Name"

maeris collection delete

Deletes a collection and all its APIs. This action is irreversible.

maeris collection delete "My API Collection" maeris collection delete "My API Collection" --confirm  # skip confirmation prompt

maeris collection stats

Shows statistics for a collection: total APIs, APIs with assertions, last run date, pass/fail rate.

maeris collection stats "My API Collection"

maeris collection export

Exports a collection to a Postman-compatible JSON file.

maeris collection export "My API Collection" --output collection.json maeris collection export "My API Collection" --format postman --output postman.json

maeris collection import

Imports a collection from a Postman JSON file.

maeris collection import collection.json maeris collection import postman_export.json --name "Imported Collection"

API Commands

maeris api list

Lists APIs within a collection.

maeris api list --collection "My API Collection" maeris api list --collection "My API Collection" --method GET

maeris api get

Shows full details of an API: method, URL, headers, body, params, and assertions.

maeris api get "Get User"

maeris api create

Creates a new API endpoint in a collection.

maeris api create \
  --collection "My API Collection" \
  --name "Create User" \
  --method POST \
  --url "{{base_url}}/api/users"

maeris api bulk

Creates multiple APIs at once from a JSON file.

maeris api bulk --collection "My API Collection" --file apis.json

maeris api update

Updates an existing API's properties.

maeris api update "Get User" --url "{{base_url}}/api/v2/users/{{id}}"
maeris api update "Get User" --method GET --name "Fetch User Profile"

maeris api delete

Deletes an API endpoint from its collection.

maeris api delete "Get User"

maeris api move

Moves an API to a different collection.

maeris api move "Get User" --to "Users Service"

maeris api clone

Creates a copy of an API within the same or a different collection.

maeris api clone "Get User" --name "Get User (v2)" maeris api clone "Get User" --name "Get User Copy" --collection "Other Collection"

maeris api search

Searches APIs by name, URL pattern, or HTTP method across all collections.

maeris api search "users" maeris api search "/api/auth" --method POST

Parameter & Header Commands

maeris api param add

Adds a query parameter, path variable, or request body field to an API.

maeris api param add "Get User" --type query --key limit --value 10
maeris api param add "Get User" --type path --key id --value "{{user_id}}"

maeris api param update

Updates an existing parameter value on an API.

maeris api param update "Get User" --key limit --value 50

maeris api param delete

Removes a parameter from an API.

maeris api param delete "Get User" --key limit

Next Steps