# add ip whitelist

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/ip_whitelist/add:
    post:
      summary: add ip whitelist
      deprecated: false
      description: >-
        There is a default limit on the number of ips that can be created, which
        can be obtained from the 'get user info' API. 

        The 'whitelist_limit' field in the returned userinfo indicates the limit
        on the number of ips.
      tags:
        - Rotation proxy/ip whitelist
        - ip whitelist
      parameters:
        - name: Authorization
          in: header
          description: ''
          example: Bearer {{AUTH_TOKEN}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                ip:
                  description: ip to add into whitelist
                  type: string
                tag:
                  description: some tag
                  type: string
              x-apifox-refs: {}
              x-apifox-orders:
                - ip
                - tag
              required:
                - ip
            example:
              ip: 127.0.0.1
              tag: office ip
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta_message:
                    type: string
                    description: success or other error msg
                  meta_status:
                    type: integer
                    description: 1 for success, negative for error
                  record:
                    type: object
                    properties:
                      created_unixtime:
                        type: integer
                      id:
                        type: integer
                      ip:
                        type: string
                      tag:
                        type: string
                      user_id:
                        type: integer
                    x-apifox-refs: {}
                    x-apifox-orders:
                      - created_unixtime
                      - id
                      - ip
                      - tag
                      - user_id
                    description: new record info
                x-apifox-refs: {}
                x-apifox-orders:
                  - meta_message
                  - meta_status
                  - record
                required:
                  - meta_message
                  - meta_status
                  - record
          headers: {}
          x-apifox-name: result
      security: []
      x-apifox-folder: Rotation proxy/ip whitelist
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/2880121/apis/api-88999354-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.ipcola.com
    description: ipcola
security: []

```