Account Edit Request

Request a profile edit on a delivered (saved) account. The assigned account manager will update the username, display name, biography, and/or profile picture as specified.

Cost: 8 credits per edit request.

Create Edit Request

POST /accounts/:id/edit-request

Submit a request to change one or more profile fields on a delivered account. The account must have an active order with an assigned account manager.

Prerequisites

• The account must have an active order with an assigned manager
• No other edit request can be in progress for the same account
• You need at least 8 credits in your balance

Request Body

Field	Type	Required	Description
requested_username	string	Yes	New username (1–24 characters)
requested_visible_name	string	Yes	New display name (1–30 characters)
requested_biography	string	No	New biography (max 80 characters)
requested_profile_picture_url	string	No	URL of the new profile picture
requested_link_in_bio	string	No	Link in bio (Instagram only, must be a valid URL)

curl -X POST https://app.tokportal.com/api/ext/accounts/{account_id}/edit-request \
  -H "X-API-Key: tok_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_username": "new_username",
    "requested_visible_name": "New Display Name",
    "requested_biography": "Updated bio text",
    "requested_profile_picture_url": "https://example.com/new-photo.jpg"
  }'

Response (201)

{
  "data": {
    "edit_request_id": "uuid",
    "account_id": "uuid",
    "status": "pending",
    "requested_username": "new_username",
    "requested_visible_name": "New Display Name",
    "requested_biography": "Updated bio text",
    "requested_profile_picture_url": "https://example.com/new-photo.jpg",
    "requested_link_in_bio": null,
    "created_at": "2026-02-25T12:00:00Z"
  },
  "credits_charged": 8,
  "credits_remaining": 42
}

Errors

Code	Status	When
SAVED_ACCOUNT_NOT_FOUND	404	Account ID not found
SAVED_ACCOUNT_NOT_OWNED	403	Account belongs to another user
EDIT_REQUEST_NO_CM	400	No manager assigned (no active order)
EDIT_REQUEST_ALREADY_EXISTS	409	Another edit request is already in progress
EDIT_REQUEST_NO_ACTIVE_ORDER	400	No active order for this account
INSUFFICIENT_CREDITS	402	Not enough credits (need 8)

List Edit Requests

GET /accounts/:id/edit-request

Returns all edit requests for the given account, newest first.

curl -X GET https://app.tokportal.com/api/ext/accounts/{account_id}/edit-request \
  -H "X-API-Key: tok_live_xxx"

Response (200)

{
  "data": [
    {
      "id": "uuid",
      "status": "pending",
      "requested_username": "new_username",
      "requested_visible_name": "New Display Name",
      "requested_biography": "Updated bio",
      "requested_profile_picture_url": null,
      "requested_link_in_bio": null,
      "feedback": null,
      "credits_cost": 8,
      "created_at": "2026-02-25T12:00:00Z",
      "updated_at": "2026-02-25T12:00:00Z",
      "finalized_at": null
    }
  ]
}

Edit Request Statuses

Status	Meaning
pending	Waiting for the manager to start
in_progress	Manager is working on it
in_review	Manager submitted changes, waiting for your review
finalized	Completed successfully

tip

You can poll GET /accounts/:id/edit-request to track the progress of your request. Once the status reaches in_review, you can review the changes made by the manager.