Skip to main content
POST
/
v1
/
accounts
/
{id}
/
process
Process Account
curl --request POST \
  --url https://onlyautomator.com/v1/accounts/{id}/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "priority": 3,
  "forceUpdate": false
}
'
{
  "status": "success",
  "taskId": "task_8f9a12b3",
  "estimatedCompletion": "2023-04-01T12:15:00Z"
}
Initiates data collection and processing for a specific OnlyFans account. This endpoint queues a task to collect metrics, content information, and subscriber data.

​
Endpoint

POST /v1/accounts/{id}/process

​
Authentication

This endpoint requires authentication with a valid API token having the write:accounts permission.
# Available URLs:
# - Local development: http://localhost:3000/v1/accounts/550e8400-e29b-41d4-a716-446655440000/process
# - Alternative local: http://localhost:3001/v1/accounts/550e8400-e29b-41d4-a716-446655440000/process
# - Production: https://onlyautomator.com/v1/accounts/550e8400-e29b-41d4-a716-446655440000/process

# Example with curl:
curl -X POST "https://onlyautomator.com/v1/accounts/550e8400-e29b-41d4-a716-446655440000/process" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "priority": 1,
    "forceUpdate": true
  }'

​
URL Parameters

​
id
string
required
The unique identifier of the account to process

​
Request Body

​
priority
number
Priority level for the task (1-5, with 1 being highest priority). Default: 3
​
forceUpdate
boolean
Whether to force a full update even if data is recent. Default: false

​
Response

​
status
string
Status of the request (“success” or “error”)
​
taskId
string
Unique identifier for the created task
​
estimatedCompletion
string
Estimated ISO timestamp for task completion

​
202 Accepted

{
  "status": "success",
  "taskId": "task_8f9a12b3",
  "estimatedCompletion": "2023-04-01T12:15:00Z"
}

​
400 Bad Request

{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'priority' must be between 1 and 5",
    "details": {
      "parameter": "priority"
    }
  }
}

​
401 Unauthorized

{
  "error": {
    "code": "authentication_required",
    "message": "Authentication is required to access this resource"
  }
}

​
403 Forbidden

{
  "error": {
    "code": "permission_denied",
    "message": "Your API token does not have the 'write:accounts' permission"
  }
}

​
404 Not Found

{
  "error": {
    "code": "resource_not_found",
    "message": "The specified account could not be found",
    "details": {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
}

​
Error Codes

Error CodeDescription
invalid_parameterA parameter is missing or invalid
authentication_requiredNo valid authentication token provided
permission_deniedToken lacks required permissions
resource_not_foundAccount ID not found
service_unavailableProcessing service temporarily unavailable
processing_in_progressAccount is already being processed

​
Notes

  1. Processing time varies based on account size and system load
  2. Real-time progress updates can be obtained through the websocket connection
  3. The system will automatically handle OnlyFans rate limits
  4. Setting high priority can affect processing of other accounts in your plan

Authorizations

​
Authorization
string
header
required

Standard user JWT token for authentication.

Path Parameters

​
id
string<uuid>
required

The unique identifier of the account to process

Body

application/json
​
priority
integer
default:3

Priority level for the task (1-5, with 1 being highest priority)

Required range: 1 <= x <= 5
​
forceUpdate
boolean
default:false

Whether to force a full update even if data is recent

Response

Task accepted

​
status
string
Example:

"success"

​
taskId
string
Example:

"task_8f9a12b3"

​
estimatedCompletion
string<date-time>
Example:

"2023-04-01T12:15:00Z"