openapi: 3.1.0
info:
  title: Saaras Techincal Reference API
  version: '2026-10-20'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-20: 5 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Saaras has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 9
    documentation: 3
    pages-with-code: 8
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-20'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.getenroute.io/docs/technical-reference/oauth2
  - https://docs.getenroute.io/docs/technical-reference/vault
  x-docs-section: technical-reference
paths:
  /:
    post:
      operationId: post
      tags:
      - Api
      summary: POST /
      x-source: https://docs.getenroute.io/docs/technical-reference/oauth2
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s -X POST localhost:1323/filter  -d \"filter_name=${OIDC_FILTER_NAME}\"  -d \"filter_type=${OIDC_FILTER_TYPE}\"  -d \"\
          filter_config\"=\"${OIDC_CONFIG}\"\n OIDC Discovery Endpoint examples # Okta Google {\n \"issuer\": \"https://dev-367091.okta.com\"\
          ,\n \"authorization_endpoint\": \"https://dev-367091.okta.com/oauth2/v1/authorize\",\n \"token_endpoint\": \"https://dev-367091.okta.com/oauth2/v1/token\"\
          ,\n \"userinfo_en"
  /globalconfig:
    post:
      operationId: post_globalconfig
      tags:
      - Globalconfig
      summary: Vault Integration Filter Configuration
      description: Creates a GlobalConfig resource for HashiCorp Vault integration using the provided configuration JSON.
      x-source: https://docs.getenroute.io/docs/technical-reference/vault
      parameters:
      - name: globalconfig_name
        in: query
        required: true
        schema:
          type: string
        description: Name of the GlobalConfig resource
      - name: globalconfig_type
        in: query
        required: true
        schema:
          type: string
        description: Type of the GlobalConfig, e.g., globalconfig_vault
      - name: config
        in: query
        required: true
        schema:
          type: string
        description: JSON string containing Vault integration settings
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth2/v1/authorize:
    post:
      operationId: post_oauth2_v1_authorize
      tags:
      - Oauth2
      summary: POST /oauth2/v1/authorize
      x-source: https://docs.getenroute.io/docs/technical-reference/oauth2
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s -X POST localhost:1323/upstream  -d \"upstream_name\"=\"${UPSTREAM_NAME}\"  -d \"upstream_ip\"=\"${UPSTREAM_IP}\"  -d\
          \ \"upstream_port\"=\"${UPSTREAM_PORT}\"  -d \"upstream_hc_path\"=\"${UPSTREAM_HC_PATH}\"  -d \"upstream_protocol\"=\"${UPSTREAM_PROTO}\"\
          \  -d \"upstream_weight\"=\"${UPSTREAM_WEIGHT}\"\n OIDC Filter config Field Description name Name of Filter. client_id Unique identity\
          \ of the client. When a client i"
  /token:
    post:
      operationId: post_token
      tags:
      - Token
      summary: POST /token
      x-source: https://docs.getenroute.io/docs/technical-reference/oauth2
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTokenResponse'
      x-evidence:
        kind: code-example
        language: http
        snippet: " POST /token HTTP/1.1\n Host: oauth2.googleapis.com\n code=4%2F0AY0e-g4tZPWVCZLB3Ggu0G6drjnN-WIRUHwcBZDUiQuj1wynOxcbKOPNsARfyHAakUk_Sw&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplayground&client_id=407408718192.apps.googleusercontent.com&client_secret=************&scope=&grant_type=authorization_code\n\
          \ HTTP/1.1 200 OK\n Content-type: application/json; charset=utf-8\n {\n \"access_token\": \"y"
  /v1/secret/data/enroutedemo.com:
    post:
      operationId: post_v1_secret_data_enroutedemo_com
      tags:
      - Secret
      summary: POST /v1/secret/data/enroutedemo.com
      x-source: https://docs.getenroute.io/docs/technical-reference/vault
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1SecretDataEnroutedemoComRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST  -H "Content-Type: application/json"  -H "X-Vault-Token: <Vault token>"  -d ''{"data": {"application-tls-cert":
          "<base64-encoded certificate>", "application-tls-key": "<base64-encoded key>"}}''  http://127.0.0.1:8200/v1/secret/data/enroutedemo.com
          Vault Integration Filter Configuration # Vault Integration global configuration needs the following config Vault Filter config # Field
          Descri'
components:
  schemas:
    PostTokenResponse:
      type: object
      properties:
        access_token:
          type: string
        scope:
          type: string
        token_type:
          type: string
        expires_in:
          type: integer
        refresh_token:
          type: string
    PostV1SecretDataEnroutedemoComRequest:
      type: object
      properties:
        data:
          type: object
          properties:
            application-tls-cert:
              type: string
            application-tls-key:
              type: string
tags:
- name: Api
- name: Globalconfig
- name: Oauth2
- name: Secret
- name: Token