Appear docs
HomepageGitHubAPI toolkitSign inGet demo
  • Getting Started
    • Welcome to Appear
    • How Appear works
    • Who is Appear for?
    • Get In Touch
    • Installation
  • Installation
    • Javascript / Typescript
    • Framework specific installations
      • NestJS
      • NextJS
      • Custom integrations
  • Explanations
    • Branches and environments
  • Connections
  • Managing your APIs
    • Creating a service
    • Add service via URL
    • Grouping & filtering
    • Editing your APIs
    • Overriding/updating a service
  • OpenAPI spec version
  • Tagging services
  • Service Resources
    • Resource map
  • Managing your organisation
    • Managing team members
    • Adding verified domains
  • Resources
    • FAQs
    • Product Map
    • Open-source
Powered by GitBook
On this page
  • Automatic discovery/creation
  • Creating a service manually

Was this helpful?

  1. Managing your APIs

Creating a service

Appear will automatically document your APIs from your network traffic, however, if you wish to start spec first, or fill a gap with an existing spec then follow our simple guide below.

PreviousConnectionsNextAdd service via URL

Last updated 18 days ago

Was this helpful?

Automatic discovery/creation

Once you've deployed Appear's package and snippet into your environment(s), your end-user's interaction with your service and subsequent network activity will generate your documentation for you.

These services will be created for you and be visible in your dashboard for you to explore and read.

If no services are found, either due to no package installation and integration or an empty branch or environment, you are able to manually upload OpenAPI specs.

Creating a service manually

Another method for Appear to document your APIs is to create a service and upload the associated json or yaml OpenAPI v3 - 3.1 or Swagger v2 file.

To do this, log into your Appear account

  1. On your dashboard page, click the Create Service button in the top right

  2. In the presented panel, enter a name for the service

  3. The slug will be automatically created, but can be edited, this will be used for the associated URL

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

  5. Click Create Service and Appear will generate your documentation

The spec upload facility allows you to upload multiple spec files associated to the one specification. It does not support the upload of multiple individual specs at once.

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 with us.

get in touch
When no services are detected or your branch/environment is empty, you are able to add a service manually.
An empty service state with a guide on what information can be added.
When you add a new service you're able to upload an OpenAPI spec.