Handle Proxy Failure
This endpoint is used to report that the currently assigned proxy for an account is failing connectivity checks. It can optionally trigger an automatic re-assignment of a new proxy. This is typically called by the backend microservice or potentially the extension (if it detects persistent failures) when attempts to use the assigned proxy fail.Authentication
This endpoint requires authentication via bearer token representing a valid user session managed by Supabase Auth (cookies). It’s intended for use by trusted backend services or the authenticated extension.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:
- Simulate a call from a service or extension with a valid user JWT.
- Use
curl
or a similar tool with a valid, current user JWT obtained from your browser’s session after logging in.
curl
, you need the JWT access token stored by Supabase Auth in your browser.
- Log in to your application normally in your browser.
- Open Developer Tools (usually F12).
- Go to the Application tab (it might be called Storage in Firefox).
- Under the Storage section, find Cookies and select your application’s domain (e.g.,
http://localhost:3000
orhttps://onlyautomator.com
). - Look for a cookie named similar to
sb-access-token
(the exact name might vary slightly based on Supabase configuration). - Copy the entire value of this cookie. This is your Bearer token.
- Use this copied value in the
Authorization: Bearer <your_copied_token>
header for yourcurl
or other API tool requests.
Response Example
Error Codes
This table provides context beyond the basic OpenAPI status codes.Status Code | Description |
---|---|
400 | Missing or invalid accountId . |
401 | Authentication token is missing or invalid. |
404 | The specified accountId does not exist. |
500 | An internal server error occurred during failure logging or the re-assignment process (if attempted). The error message in the response might provide more details. |
Code Examples
Notes
- If
autoReassign
istrue
(the default), this endpoint triggers the proxy assignment logic to find a replacement. - The re-assignment process respects the
proxy_region_preference
if set. - If re-assignment fails (e.g., no available proxies), the response will indicate
reassigned: false
and may include an error message (often in a 500 response).
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
Bearer token for authentication (JWT)
Path Parameters
The unique identifier of the OnlyFans account.
Body
application/json