> ## Documentation Index
> Fetch the complete documentation index at: https://gcore.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an advanced rules descriptor



## OpenAPI

````yaml /api-reference/services_docs_mintlify/waap_api.yaml get /waap/v1/advanced-rules/descriptor
openapi: 3.1.0
info:
  title: Gcore OpenAPI – WAAP API
  description: >-
    This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore
    products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS
    Protection, Object Storage, Streaming, and FastEdge services.
  contact:
    email: support@gcore.com
  version: 574b1c4d1132
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - name: API Discovery
  - name: Advanced Rules
  - name: Analytics
  - name: Custom Page Sets
  - name: Custom Rules
  - name: Domains
  - name: Filter Templates
  - name: Firewall Rules
  - name: IP Reputation
  - name: IP Spotlight
  - name: Network Organizations
  - name: Policies
  - name: Security Insights
  - name: Tags
  - name: WAAP Service
paths:
  /waap/v1/advanced-rules/descriptor:
    get:
      tags:
        - Advanced Rules
      summary: Retrieve an advanced rules descriptor
      operationId: get_advanced_rule_descriptor_v1_advanced_rules_descriptor_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdvancedRuleDescriptorResponse'
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/APIError'
              example:
                type: http-bad-request
                title: Bad Request
                status: 400
                detail: 'Invalid domain name: '''''''''
          description: Bad Request
        '401':
          description: Unauthorized
          content:
            application/problem+json:
              example:
                detail: Auth token is missing or invalid
        '403':
          description: Unauthenticated
          content:
            application/problem+json:
              example:
                detail: Permission denied
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/APIError'
              example:
                type: http-not-found
                title: Not Found
                status: 404
                detail: The resource is not found
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/APICompositeError'
              example:
                type: request-validation-failed
                title: Request validation error.
                status: 422
                detail: One or more fields have validation errors.
                errors:
                  - loc:
                      - body
                      - name
                    detail: Input should be a valid string
                  - loc:
                      - body
                      - date
                    detail: Field required
                  - loc:
                      - query
                      - limit
                    detail: Field required
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/APIError'
              example:
                type: internal-server-error
                title: Internal server error.
                status: 500
                detail: >-
                  An unexpected condition was encountered which prevented the
                  server from fulfilling the request.
          description: Internal Server Error
components:
  schemas:
    AdvancedRuleDescriptorResponse:
      properties:
        version:
          type: string
          title: Version
          description: The descriptor's version
        objects:
          anyOf:
            - items:
                $ref: '#/components/schemas/AdvancedRuleDescriptor'
              type: array
            - type: 'null'
          title: Objects
      type: object
      required:
        - version
      title: AdvancedRuleDescriptorResponse
      description: A response from a request to retrieve an advanced rules descriptor
    APIError:
      properties:
        type:
          type: string
          title: Type
          description: A URI identifier that categorizes the type of error.
        title:
          type: string
          title: Title
          description: A brief, human-readable title for the error.
        status:
          type: integer
          title: Status
          description: The HTTP status code applicable to this error.
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
          description: A detailed human-readable explanation of the error.
      type: object
      required:
        - type
        - title
        - status
        - detail
      title: APIError
    APICompositeError:
      properties:
        type:
          type: string
          title: Type
          description: A URI identifier that categorizes the type of error.
        title:
          type: string
          title: Title
          description: A brief, human-readable title for the error.
        status:
          type: integer
          title: Status
          description: The HTTP status code applicable to this error.
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
          description: A detailed human-readable explanation of the error.
        errors:
          items:
            $ref: '#/components/schemas/APIFieldError'
          type: array
          title: Errors
          description: A list of detailed errors for individual fields.
      type: object
      required:
        - type
        - title
        - status
        - detail
        - errors
      title: APICompositeError
    AdvancedRuleDescriptor:
      properties:
        name:
          type: string
          title: Name
          description: The object's name
        type:
          type: string
          title: Type
          description: The object's type
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: The object's description
        attrs:
          anyOf:
            - items:
                $ref: '#/components/schemas/AdvancedRuleDescriptorAttr'
              type: array
            - type: 'null'
          title: Attrs
          description: The object's attributes list
      type: object
      required:
        - name
        - type
      title: AdvancedRuleDescriptor
      description: Advanced rules descriptor object
    APIFieldError:
      properties:
        loc:
          anyOf:
            - items:
                anyOf:
                  - type: integer
                  - type: string
              type: array
            - {}
          title: Loc
          description: The location of the field or a character number causing the error.
        detail:
          type: string
          title: Detail
          description: A human-readable message describing the error.
      type: object
      required:
        - loc
        - detail
      title: APIFieldError
    AdvancedRuleDescriptorAttr:
      properties:
        name:
          type: string
          title: Name
          description: The attribute's name
        type:
          type: string
          title: Type
          description: The attribute's type
        hint:
          anyOf:
            - type: string
            - type: 'null'
          title: Hint
          description: The attribute's hint
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: The attribute's description
        args:
          anyOf:
            - items:
                $ref: '#/components/schemas/AdvancedRuleDescriptorArg'
              type: array
            - type: 'null'
          title: Args
          description: A list of arguments for the attribute
      type: object
      required:
        - name
        - type
      title: AdvancedRuleDescriptorAttr
      description: An attribute of a descriptor's object
    AdvancedRuleDescriptorArg:
      properties:
        name:
          type: string
          title: Name
          description: The argument's name
        type:
          type: string
          title: Type
          description: The argument's type
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: The argument's description
      type: object
      required:
        - name
        - type
      title: AdvancedRuleDescriptorArg
      description: An argument of a descriptor's object
  securitySchemes:
    APIKey:
      description: >-
        API key for authentication. Make sure to include the word `apikey`,
        followed by a single space and then your token.

        Example: `apikey 1234$abcdef`
      type: apiKey
      in: header
      name: Authorization

````