Update an existing post

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

---

Updates the authenticated user’s own post in-place. The owner field is derived from the authentication token and must not be supplied in the request body. Editable fields: message, tags, mentions, attachments.

PUT /api/v1/posts/{postId}

Update an existing post

cURL

curl --request PUT \
  --url https://public-api.etoro.com/api/v1/posts/{postId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>' \
  --data '
{
  "message": "Updating my view on $TSLA — still bullish but watching earnings closely.",
  "attachments": [
    {
      "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
      "title": "Tesla Q4 Earnings Chart",
      "host": "cdn.etoro.com",
      "description": "Tesla quarterly earnings breakdown",
      "mediaType": "Image",
      "media": {
        "image": {
          "width": 1200,
          "height": 630,
          "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
        }
      }
    }
  ]
}
'

import requests

url = "https://public-api.etoro.com/api/v1/posts/{postId}"

payload = {
    "message": "Updating my view on $TSLA — still bullish but watching earnings closely.",
    "attachments": [
        {
            "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
            "title": "Tesla Q4 Earnings Chart",
            "host": "cdn.etoro.com",
            "description": "Tesla quarterly earnings breakdown",
            "mediaType": "Image",
            "media": { "image": {
                    "width": 1200,
                    "height": 630,
                    "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
                } }
        }
    ]
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<x-api-key>",
    "x-user-key": "<x-user-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<x-api-key>',
    'x-user-key': '<x-user-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Updating my view on $TSLA — still bullish but watching earnings closely.',
    attachments: [
      {
        url: 'https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg',
        title: 'Tesla Q4 Earnings Chart',
        host: 'cdn.etoro.com',
        description: 'Tesla quarterly earnings breakdown',
        mediaType: 'Image',
        media: {
          image: {
            width: 1200,
            height: 630,
            url: 'https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg'
          }
        }
      }
    ]
  })
};

fetch('https://public-api.etoro.com/api/v1/posts/{postId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/posts/{postId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => 'Updating my view on $TSLA — still bullish but watching earnings closely.',
    'attachments' => [
        [
                'url' => 'https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg',
                'title' => 'Tesla Q4 Earnings Chart',
                'host' => 'cdn.etoro.com',
                'description' => 'Tesla quarterly earnings breakdown',
                'mediaType' => 'Image',
                'media' => [
                                'image' => [
                                                                'width' => 1200,
                                                                'height' => 630,
                                                                'url' => 'https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-api-key: <x-api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <x-user-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/posts/{postId}"

	payload := strings.NewReader("{\n  \"message\": \"Updating my view on $TSLA — still bullish but watching earnings closely.\",\n  \"attachments\": [\n    {\n      \"url\": \"https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg\",\n      \"title\": \"Tesla Q4 Earnings Chart\",\n      \"host\": \"cdn.etoro.com\",\n      \"description\": \"Tesla quarterly earnings breakdown\",\n      \"mediaType\": \"Image\",\n      \"media\": {\n        \"image\": {\n          \"width\": 1200,\n          \"height\": 630,\n          \"url\": \"https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg\"\n        }\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("x-user-key", "<x-user-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://public-api.etoro.com/api/v1/posts/{postId}")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<x-api-key>")
  .header("x-user-key", "<x-user-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"Updating my view on $TSLA — still bullish but watching earnings closely.\",\n  \"attachments\": [\n    {\n      \"url\": \"https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg\",\n      \"title\": \"Tesla Q4 Earnings Chart\",\n      \"host\": \"cdn.etoro.com\",\n      \"description\": \"Tesla quarterly earnings breakdown\",\n      \"mediaType\": \"Image\",\n      \"media\": {\n        \"image\": {\n          \"width\": 1200,\n          \"height\": 630,\n          \"url\": \"https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg\"\n        }\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/posts/{postId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<x-api-key>'
request["x-user-key"] = '<x-user-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"Updating my view on $TSLA — still bullish but watching earnings closely.\",\n  \"attachments\": [\n    {\n      \"url\": \"https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg\",\n      \"title\": \"Tesla Q4 Earnings Chart\",\n      \"host\": \"cdn.etoro.com\",\n      \"description\": \"Tesla quarterly earnings breakdown\",\n      \"mediaType\": \"Image\",\n      \"media\": {\n        \"image\": {\n          \"width\": 1200,\n          \"height\": 630,\n          \"url\": \"https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg\"\n        }\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "owner": {
    "id": "7890",
    "username": "johndoe",
    "firstName": "John",
    "lastName": "Doe",
    "avatar": {
      "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
      "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
      "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
      "svg": {
        "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
        "backgroundColor": "#2196F3",
        "textColor": "#FFFFFF"
      }
    },
    "roles": [
      "Regular"
    ],
    "isBlocked": false,
    "isPrivate": false,
    "countryCode": 840,
    "piLevel": 0
  },
  "obsoleteId": "12345",
  "created": "2025-01-15T10:30:00Z",
  "message": {
    "text": "Excited about $TSLA earnings next week!",
    "languageCode": "en"
  },
  "updated": "2025-01-16T08:00:00Z",
  "isDeleted": false,
  "type": "Default",
  "metadata": {
    "share": {
      "sharedPost": "<unknown>",
      "sharedOriginPost": "<unknown>"
    },
    "marketEvent": {
      "earningReportId": 1042,
      "market": {
        "id": "TSLA",
        "symbolName": "TSLA",
        "displayName": "Tesla",
        "updated": "2025-01-15T00:00:00Z",
        "assetType": "Stocks",
        "internalId": 59114,
        "avatar": {
          "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
          "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
          "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
          "svg": {
            "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
            "backgroundColor": "#CC0000",
            "textColor": "#FFFFFF"
          }
        },
        "application": "eToro",
        "metadata": "{}",
        "assetTypeId": 10,
        "assetTypeSubCategoryId": 101
      },
      "stocksIndustryId": 15,
      "earningsDate": "2025-01-15T10:30:00Z",
      "isBeforeMarketOpen": true,
      "earningsYear": 2025,
      "earningsQuarter": 1,
      "verified": true,
      "marketCap": 800000000000,
      "estimatedEps": 1.42,
      "estimatedSales": 25000000000,
      "tagName": "Reports",
      "textKey": 3
    },
    "trade": {
      "type": "Open",
      "positionId": 987654321,
      "market": {
        "id": "TSLA",
        "symbolName": "TSLA",
        "displayName": "Tesla",
        "updated": "2025-01-15T00:00:00Z",
        "assetType": "Stocks",
        "internalId": 59114,
        "avatar": {
          "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
          "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
          "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
          "svg": {
            "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
            "backgroundColor": "#CC0000",
            "textColor": "#FFFFFF"
          }
        },
        "application": "eToro",
        "metadata": "{}",
        "assetTypeId": 10,
        "assetTypeSubCategoryId": 101
      },
      "gain": 12.5,
      "rate": 245.3,
      "direction": "Long"
    },
    "order": {
      "type": "Open",
      "orderId": 123456789,
      "market": {
        "id": "TSLA",
        "symbolName": "TSLA",
        "displayName": "Tesla",
        "updated": "2025-01-15T00:00:00Z",
        "assetType": "Stocks",
        "internalId": 59114,
        "avatar": {
          "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
          "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
          "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
          "svg": {
            "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
            "backgroundColor": "#CC0000",
            "textColor": "#FFFFFF"
          }
        },
        "application": "eToro",
        "metadata": "{}",
        "assetTypeId": 10,
        "assetTypeSubCategoryId": 101
      },
      "rate": 240,
      "direction": "Long"
    },
    "copy": {
      "type": "Start",
      "user": {
        "id": "7890",
        "username": "johndoe",
        "firstName": "John",
        "lastName": "Doe",
        "avatar": {
          "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
          "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
          "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
          "svg": {
            "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
            "backgroundColor": "#2196F3",
            "textColor": "#FFFFFF"
          }
        },
        "roles": [
          "Regular"
        ],
        "isBlocked": false,
        "isPrivate": false,
        "countryCode": 840,
        "piLevel": 0
      }
    },
    "poll": {
      "id": 55,
      "title": "Where do you see $TSLA by year-end?",
      "gcid": 7890,
      "options": [
        {
          "id": 1,
          "index": 1,
          "text": "Bullish",
          "isUserVoted": false,
          "votesCount": 128
        }
      ]
    },
    "article": {
      "id": 9001,
      "title": "Why TSLA Could Hit $500 This Year",
      "url": "https://etoro.com/news/markets/articles/why-tsla-could-hit-500",
      "rating": "Bullish",
      "featuredImage": {
        "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
        "title": "Tesla Q4 Earnings Chart",
        "host": "cdn.etoro.com",
        "description": "Tesla quarterly earnings breakdown",
        "mediaType": "Image",
        "media": {
          "image": {
            "width": 1200,
            "height": 630,
            "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
          },
          "video": {
            "videoSourceId": "dQw4w9WgXcQ",
            "videoSource": "YouTube",
            "image": {
              "width": 1280,
              "height": 720,
              "url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
            }
          }
        }
      },
      "body": "<p>Tesla has shown strong fundamentals...</p>",
      "bodyPreview": "Tesla has shown strong fundamentals this quarter...",
      "aiSummary": "Analyst argues Tesla's pipeline supports a $500 target by year-end.",
      "languageCode": "en",
      "status": "Published",
      "editStatus": "None",
      "ownerId": 7890,
      "created": "2025-01-15T10:30:00Z",
      "updated": "2025-01-16T08:00:00Z",
      "published": "2025-01-16T09:00:00Z",
      "readingTimeMinutes": 3.5,
      "wordCount": 750
    }
  },
  "attachments": [
    {
      "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
      "title": "Tesla Q4 Earnings Chart",
      "host": "cdn.etoro.com",
      "description": "Tesla quarterly earnings breakdown",
      "mediaType": "Image",
      "media": {
        "image": {
          "width": 1200,
          "height": 630,
          "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
        },
        "video": {
          "videoSourceId": "dQw4w9WgXcQ",
          "videoSource": "YouTube",
          "image": {
            "width": 1280,
            "height": 720,
            "url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
          }
        }
      }
    }
  ],
  "tags": [
    {
      "market": {
        "id": "TSLA",
        "symbolName": "TSLA",
        "displayName": "Tesla",
        "updated": "2025-01-15T00:00:00Z",
        "assetType": "Stocks",
        "internalId": 59114,
        "avatar": {
          "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
          "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
          "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
          "svg": {
            "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
            "backgroundColor": "#CC0000",
            "textColor": "#FFFFFF"
          }
        },
        "application": "eToro",
        "metadata": "{}",
        "assetTypeId": 10,
        "assetTypeSubCategoryId": 101
      }
    }
  ],
  "mentions": [
    {
      "user": {
        "id": "7890",
        "username": "johndoe",
        "firstName": "John",
        "lastName": "Doe",
        "avatar": {
          "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
          "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
          "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
          "svg": {
            "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
            "backgroundColor": "#2196F3",
            "textColor": "#FFFFFF"
          }
        },
        "roles": [
          "Regular"
        ],
        "isBlocked": false,
        "isPrivate": false,
        "countryCode": 840,
        "piLevel": 0
      },
      "isDirect": true
    }
  ],
  "isSpam": false,
  "editStatus": "None"
}

Authorizations

Authorization · string · header · required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

x-request-id · string<uuid> · required

A unique request identifier.

Example:

"daa876a8-8f09-4a10-a46f-177911b833b5"

x-api-key · string<password> · required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key · string<password> · required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

postId · string<uuid> · required

ID of the post to update (UUID)

Body

application/json

Fields to update on the post

Request body for updating a post. Owner is derived from the auth token — do not supply it.

message · string

Updated text content

Example:

"Updating my view on $TSLA — still bullish but watching earnings closely."

attachments · object[]

List of attachments for a post or comment (request body format)

Show child attributes

Response

200

application/json

Post updated successfully

A feed post returned by create / update / get-by-ID

id · string

Unique post ID

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

owner · object

eToro user profile (slim projection)

Show child attributes

obsoleteId · string

Legacy numeric post ID

Example:

"12345"

created · string<date-time>

Creation timestamp

Example:

"2025-01-15T10:30:00Z"

message · object

Post/comment text content

Show child attributes

updated · string<date-time> | null

Last-edited timestamp

Example:

"2025-01-16T08:00:00Z"

isDeleted · boolean

True when the post has been soft-deleted

Example:

false

type · enum<string>

Post type

Available options: Default, Share, MarketEvent, Trade, Order, Copy, Poll, Article

Example:

"Default"

metadata · object

Post type–specific metadata — only the relevant key is populated

Show child attributes

attachments · object[]

Show child attributes

tags · object[]

Show child attributes

mentions · object[]

Show child attributes

isSpam · boolean

True when the post is classified as spam

Example:

false

editStatus · enum<string>

Edit lifecycle status

Available options: None, Edited, Moderated

Example:

"None"