# Manually enter API details

If you’re building a backend application and don’t have it all documented yet, you can manually enter your API information.

  1. On the Test Suites page, click on the "Create" button

  2. Click on the "Enter API Details" button

  3. Enter basic details about your API, like URL, headers, path/query params, and request body here

Some things to keep in mind while entering your API information:

  • You can use a domain, an IP or localhost for the URL.
  • Headers, query params, path params, and request body should be valid JSON.
  • Path params should be specified in the URL using single curly braces, like this:
    https://foobar.com/create/user/{user-id}
    Example value for path params should be specified in the "Path Params" input as a JSON, like this:
    { "user-id": 12345 }
  • Headers can be used to specify things like auth-related information, like Bearer tokens, JWT tokens, session cookies, etc. We recommend using variables for this.
  • We currently support only JSON, formdata and URL-encoded bodies. gRPC and GraphQL are in development and will be supported soon.
  1. Click on "Generate" to start test generation. This typically takes 3-4 minutes, depending on the size of the API payload.

# Using XML bodies

NOTE: This is available only on our Enterprise plan for select users. If you're interested in enabling this, please reach out to us at enterprise@kusho.ai or your RM.

For adding XML body, switch to XML format from the request body dropdown and add "Content-Type: application/xml" or "Content-Type: text/xml" in headers as shown below.

Please note that you need KushoAI Chrome extension version 1.13 or above for running payloads with XML bodies.

Current version of XML body support has limited features. When you add an API with XML body, only 1 test (valid input) will be generated. We're planning to add automated test generation in upcoming versions. Until then, you can use the "Add tests using payload" feature to manually add tests.