post Create or update proxy comment.

/api/client/v1/proxies/{id}/comment
comment

A new comment is created for the specified proxy, replacing the old one (if it exists). Commenting can help organize proxies by tags, track proxy rotation/expiration, or store notes related to specific use cases (e.g., restricted access to certain services). Please note that posting a new comment completely overwrites any existing comment for the proxy.

Parameters

id
Required
Proxy ID. The comment will be assigned to the specified proxy using its ID, which is generated by the OnlineProxy server upon purchase.
In: path
Schema:
  • integer:int64
    Example: 1

Request Body

Content Type:
application/json
  • Schema
  • Example
  • object
    CreateOrUpdateProxyCommentRequest
    Example: {"comment":"string"}
    Properties:
    • comment
      string
      Required
      Comment for the proxy. You can add any information you may need or want, but keep in mind the maximum length of the comment.
      Example: "string"
      Maximum number of items: 255

Responses

200

OK. The comment for the specified proxy has been successfully updated.
Content Type:
application/json
  • Schema
  • Example
  • object
    Example: {"comment":"string"}
    Properties:
    • comment
      string
      Comment
      Example: "string"

401

Unauthorized. Missing or invalid authentication token, please check the Authorization header.
Content Type:
application/json
  • Schema
  • Example
  • object
    ErrorResponse
    Example: {"message":"string","errors":{}}
    Properties:
    • message
      string
      Required
      Error message
      Example: "string"
    • errors
      object or null
      Input validation errors
      Example: {}

403

Forbidden. API access denied. Please check your Account settings to ensure that API access is enabled and your IP address is listed in the Access IPs section. If the issue persists, please contact us.

Content Type:
application/json
  • Schema
  • Example
  • object
    ErrorResponse
    Example: {"message":"string","errors":{}}
    Properties:
    • message
      string
      Required
      Error message
      Example: "string"
    • errors
      object or null
      Input validation errors
      Example: {}

422

Unprocessable Entity. Please check the length of the comment; it cannot exceed 255 characters.
Content Type:
application/json
  • Schema
  • Example
  • object
    ErrorResponse
    Example: {"message":"string","errors":{}}
    Properties:
    • message
      string
      Required
      Error message
      Example: "string"
    • errors
      object or null
      Input validation errors
      Example: {}