Skip to main content
PUT
/
api
/
proxy
/
account
/
{accountId}
/
preference
Set Proxy Preferences
curl --request PUT \
  --url https://onlyautomator.com/api/proxy/account/{accountId}/preference \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "proxy_region_preference": "DE",
  "proxy_city_preference": "Berlin",
  "proxy_is_active": true
}
'
{
  "success": true,
  "message": "Proxy preferences updated successfully",
  "data": {
    "proxy_region_preference": "DE",
    "proxy_city_preference": "Berlin",
    "proxy_is_active": true
  }
}

​
Set Proxy Preferences

This endpoint allows updating specific proxy-related preferences for an account, such as the preferred region for automatic assignments and whether the proxy configuration is active. Only the preferences provided in the request body are updated.

​
Authentication

This endpoint requires authentication via bearer token representing a valid user session managed by Supabase Auth (cookies).Testing Note: Due to the requirement for a live user session, this endpoint cannot be successfully tested directly using the ‘Send’ button in this documentation with a static token.To test:
  1. Call this endpoint from your web application after logging in.
  2. Use curl or a similar tool with a valid, current user JWT obtained from your browser’s session after logging in.
Retrieving JWT Token for Testing: To test endpoints requiring a user session with tools like curl, you need the JWT access token stored by Supabase Auth in your browser.
  1. Log in to your application normally in your browser.
  2. Open Developer Tools (usually F12).
  3. Go to the Application tab (it might be called Storage in Firefox).
  4. Under the Storage section, find Cookies and select your application’s domain (e.g., http://localhost:3000 or https://onlyautomator.com).
  5. Look for a cookie named similar to sb-access-token (the exact name might vary slightly based on Supabase configuration).
  6. Copy the entire value of this cookie. This is your Bearer token.
  7. Use this copied value in the Authorization: Bearer <your_copied_token> header for your curl or other API tool requests.
Note: This token has a limited lifetime and you’ll need to copy a fresh one after it expires.

​
Response Example

{
  "data": {
    "proxy_region_preference": "GB",
    "proxy_is_active": true,
    "message": "Proxy preferences updated successfully"
  }
}

​
Error Codes

This table provides context beyond the basic OpenAPI status codes.
Status CodeDescription
400Invalid request body (e.g., no preferences provided, invalid country code format).
401Authentication token is missing or invalid.
404The specified accountId does not exist.
500An internal server error occurred during the database update.

​
Code Examples

// Using fetch
const updateProxyPrefs = async (accountId, apiToken, prefs) => {
  const response = await fetch(`https://onlyautomator.com/api/proxy/account/${accountId}/preference`, {
    method: 'PUT',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiToken}`
    },
    body: JSON.stringify(prefs)
  });
  
  if (!response.ok) {
     const errorData = await response.json();
     throw new Error(`API Error (${response.status}): ${errorData.error}`);
  }
  return await response.json();
};

// Example usage: Set preferred region to Germany
const preferences = {
  proxy_region_preference: 'DE'
};

updateProxyPrefs('acc123', 'your_api_token', preferences)
  .then(data => console.log('Preferences update result:', data))
  .catch(error => console.error('Error updating preferences:', error));

// Example usage: Deactivate proxy
const deactivatePref = {
  proxy_is_active: false
};

updateProxyPrefs('acc456', 'your_api_token', deactivatePref)
  .then(data => console.log('Deactivation result:', data));

​
Notes

  • Setting proxy_is_active to false is a non-destructive way to disable the proxy temporarily.
  • The proxy_region_preference should be a valid ISO 3166-1 alpha-2 country code.

Authorizations

​
Authorization
string
header
required

Standard user JWT token for authentication.

Headers

​
Authorization
string
required

Bearer token for authentication (JWT)

Path Parameters

​
accountId
string<uuid>
required

The unique identifier of the OnlyFans account.

Body

application/json
​
proxy_region_preference
string | null

Preferred ISO country code for auto-assignment (e.g., 'DE', 'US', null for any).

Example:

"DE"

​
proxy_city_preference
string | null

Preferred city within the chosen country (or null for any).

Example:

"Berlin"

​
proxy_is_active
boolean | null

Set to false to temporarily disable proxy usage, true to enable.

Example:

true

Response

Proxy preferences updated successfully.

​
success
boolean
Example:

true

​
message
string
Example:

"Proxy preferences updated successfully"

​
data
object