Apicat Docs
  1. References
Apicat Docs
  • What is Apicat?
  • Send requests
    • Create requests
      • Request basics
      • Parameters and body
      • Request headers
      • Request settings
      • Dynamic values
      • HTTP/2
      • SOAP/WebService
    • Authentication and authorization
      • Overview
      • CA and client certificates
      • Authorization types supported by Apidog
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk Authentication
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Response and cookies
      • Overview
      • API response in Apidog
      • Create and send cookies
      • Debug requests
    • Dynamic values Modules
      • Airline
      • Animal
      • Color
      • Commerce
      • Company
      • Database
      • Datatype
      • Date
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • Image
      • Internet
      • Location
      • Lorem
      • Music
      • Number
      • Person
      • Phone
      • Science
      • String
      • System
      • Vehicle
      • Word
  • Environments & variables
    • Overview
    • Using variables
    • Environments & services
  • Pre/Post processors
    • Overview
    • Assertion
    • Extract variable
    • Wait
    • Database operations
      • Overview
      • MySQL
      • MongoDB
      • Redis
      • Oracle Client
    • Using scripts
      • Overview
      • Pre processor scripts
      • Post processor scripts
      • Public scripts
      • Postman scripts reference
      • Calling other programming languages
      • Using JS libraries
      • Visualizing responses
      • Script examples
        • Assertion scripts
        • Using variables in scripts
        • Using scripts to modify request messages
        • Other examples
  • Best practices
    • How to handle API signatures
    • How to access OAuth 2.0 protected APIs
    • Apidog collaboration workflow
    • Managing authentication state in Apidog
  • Account & preferences
    • Account settings
    • Generate OpenAPI access token
    • Language settings
    • Hot keys
    • Network proxy configuration
    • Data backup
    • Updating Apidog
    • Deleting account
    • Experimental Features
  • References
    • API-Design First Approach
    • Apidog OpenAPI/Swagger Specificaiton Extensions
    • JSONPath
    • XPath
    • Regular Expressions
    • JSON Schema
    • CSV File Format
    • Install Java Environment
    • Runner deployment environment
    • Apidog flavored Markdown
  1. References

Apidog OpenAPI/Swagger Specificaiton Extensions

Specify the Folder to Which an Endpoint Belongs#

1.
Apidog will prioritize using the x-apidog-folder field. If this field does not exist, it will use the first value in the tags field.
2.
Use slashes / to separate Multi-level folders. Note that both backslash \ and forward slash / are special characters that require escaping. To represent the character forward slash /, please use \/, and to represent the character \, please use \\.
"paths": {
  "/pets": {
     "post": {
         ...
         "operationId": "addPet",     
         "x-apidog-folder": "Pet Store/Pet Information"
     }
  }
}
Swagger annotation example:

Endpoint Status#

Check the status of endpoint: x-apidog-status
StatusDescription
(Designing)designing
(Pending)pending
(Developing)developing
(Integrating)integrating
(Testing)testing
(Tested)tested
(Released)released
(Deprecated)deprecated
(Exception)exception
(Obsolete)obsolete
(To be Deprecated)to be deprecated
"paths": {
    "/pets": {
        "post": {
            ...
            "operationId": "addPet",     
            "x-apidog-status": "released"
        }
    }
}
Swagger annotation example:

Maintainer#

Maintainer for the specified endpoint: x-apidog-maintainer. Its value is the nickname or username of the Apidog user within the team.
"paths": {
    "/pets": {
        "post": {
            ...   
            "x-apidog-maintainer": "david"
        }
    }
}
Swagger Annotation Example
@Operation(extensions = {
    @Extension(properties = {
            @ExtensionProperty(name = "apidog-maintainer", value = "david")})
})
public Response createPet() {...}
Modified at 2025-06-25 07:57:16
Previous
API-Design First Approach
Next
JSONPath
Built with