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

# Add Whitelisted IPs

> Adds up to 10 IP addresses per request.




## OpenAPI

````yaml api-reference/ref/add-whitelist-ip.yaml post /configuration/active/whitelisted-ips
openapi: 3.0.3
info:
  title: Active Whitelisted IPs API
  version: 1.0.0
  description: >
    API to add whitelisted IP addresses.

    **Example Request:**

    ```sh curl -X POST
    "https://app-api.geonode.com/api/configuration/active/whitelisted-ips" \
      -H "Authorization: Basic base64(username:password)" \
      -H "Content-Type: application/json" \
      -d '{"ips": [{"ip": "161.142.148.140", "description": "mac-m1"}]}'
    ```
servers:
  - url: https://app-api.geonode.com/api
security: []
paths:
  /configuration/active/whitelisted-ips:
    post:
      summary: Add Whitelisted IPs
      description: |
        Adds up to 10 IP addresses per request.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ips:
                  type: array
                  items:
                    type: object
                    properties:
                      ip:
                        type: string
                        description: The IP address being added to the whitelist.
                        example: 161.142.148.140
                      description:
                        type: string
                        description: >-
                          A user-defined label or identifier for the whitelisted
                          IP.
                        example: mac-m1
      responses:
        '200':
          description: Successfully added whitelisted IPs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: A list of successfully whitelisted IP addresses.
                    items:
                      type: object
                      properties:
                        ip:
                          type: string
                          description: The IP address that was whitelisted.
                          example: 161.142.148.150
                        description:
                          type: string
                          description: A user-defined label or identifier for the IP.
                          example: updated-description
                        _id:
                          type: string
                          description: A unique identifier assigned to the whitelisted IP.
                          example: 67a0a5bbb412ddaf6f139b3b
                  message:
                    type: object
                    description: Details about the status of the whitelist update.
                    properties:
                      title:
                        type: string
                        description: A short title summarizing the update status.
                        example: Updated
                      body:
                        type: string
                        description: A message detailing the outcome of the operation.
                        example: Whitelisted IPs saved.
                      variant:
                        type: string
                        description: The status variant indicating success or failure.
                        example: success
        '400':
          description: Bad Request - Invalid input.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message.
                    example: Invalid input data.
        '401':
          description: Unauthorized - Invalid Credentials.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message.
                    example: Unauthorized - Invalid API key or credentials.
      security:
        - BasicAuth: []
components:
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
      description: Basic authentication using `username:password`.

````