Overriding/updating a service

Appear will (soon) offer automatic diffs when it comes to API versions and changes seen in your network traffic, however you can import a spec if required.

Automatic updates (soon)

Appear passively watches your network traffic to generate your documentation, and uses that mechanism to detect deltas from your documentation and current network traffic.

This will provide you with a simple interface to accept or deny detected changes, and create a changelog entry for your team to stay up to date with all service changes that occur.

Import spec with a service

Appear supports manually uploading a spec within an existing service, which will override the existing schema and documentation.

You can override an existing service by uploading an OpenAPI spec from the menu in the top-right of the service

1. Click into the service you wish to modify from your service list

2. Click import in the top right corner of the interface

3. Drag and drop, or use your system's file explorer to upload the associated API specification

4. Click import OpenAPI and Appear will generate an updated service based off your uploaded spec

You may need to refresh the page if the service doesn't appear in your service list after a successful upload.

If you have any queries or require support with the above instructions, please get in touch with us.