[Step 2/5] Upload and set article cover image (optional)

Step 2 of 5 (optional) — Upload a cover image and attach it to the draft.

article_id: obtained from Step 1
cover_image: an https:// URL or a local file path

This step can be skipped if you don’t need a cover image.

APIリファレンスに戻る

/Article Endpoints

TwexAPI REST

PUT/x/articles/{article_id}/cover

API 認証

AuthorizationBearer token · header必須

TwexAPIのグローバル認証トークン (Bearer Token)。ヘッダーに含める必要があります：Authorization: Bearer <YOUR_TWEXAPI_KEY>。

パスパラメータ

article_idstring必須

X記事の一意のID

リクエストボディ

必須application/json

cookiestring必須

ユーザー自身が承認した Twitter セッション資格情報または auth_token（BYOC — Bring Your Own Cookie）。機密情報は保存されず、完全なステートレスプロキシとして実行されます。詳細は [認証・セキュリティガイド](/ja/authentication#write-operations--byoc-bring-your-own-cookie) および [Cookie 取得手順](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie) を参照。

cover_imagestring必須

Cover image: https URL or local file path

レスポンス

200成功時のレスポンス

codeinteger必須

HTTP ステータスコード（200 は成功）

msgstring必須

レスポンスメッセージ（例: 'success'）

dataArticleCoverData | any

返却されるコアデータオブジェクトまたは配列

プロパティを表示

Any of:

ArticleCoverData

media_idstring必須

Media ID of the uploaded cover image on X

any

any

422パラメータバリデーションエラー

detailValidationError[]

プロパティを表示

Array of ValidationError

locstring | integer[]必須

プロパティを表示

Array of string | integer

Any of:

string

string

integer

integer

msgstring必須

レスポンスメッセージ（例: 'success'）

typestring必須

inputany

ctxobject

429Daily tweet limit reached

500Server error

⚡インタラクティブテスト / Try APIPUT/x/articles/{article_id}/cover

Live Console

🌐対象サーバー:https://api.twexapi.io

● 本番環境レディ

✍️

書き込み操作の認証情報ガイド（TwexAPIキー + Twitter Cookie）

1. TwexAPIプラットフォームキー (Bearer Token): 下記の「API認証」に入力してください（API呼び出しと課金認証に使用）。

2. TwitterアカウントCookie: ツイート・いいね・フォロー等の書き込み操作のため、下記リクエストボディの cookie フィールドに対象TwitterアカウントのCookie（例: auth_token=...; ct0=...）を入力してください。

🔑API 認証

キーを記憶コード例に同期

TwexAPI プラットフォームキー Bearer Token必須

すべてのTwexAPIエンドポイントで使用されるAPIキー。ダッシュボードで取得できます。

⚙️リクエストパラメータ (1)

article_idpath

必須X記事の一意のID

📝リクエストボディapplication/json

cookiestringTwitterアカウント Cookie / Auth Token

必須ユーザー自身が承認した Twitter セッション資格情報または auth_token（BYOC — Bring Your Own Cookie）。機密情報は保存されず、完全なステートレスプロキシとして実行されます。詳細は [認証・セキュリティガイド](/ja/authentication#write-operations--byoc-bring-your-own-cookie) および [Cookie 取得手順](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie) を参照。

cover_imagestring

必須Cover image: https URL or local file path

💡 クイック送信:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

リクエスト例

curl -X PUT "https://api.twexapi.io/x/articles/string/cover" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "cookie": "string",
  "cover_image": "string"
}'

const response = await fetch("https://api.twexapi.io/x/articles/string/cover", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "cookie": "string",
  "cover_image": "string"
})
});

import requests

response = requests.put(
    "https://api.twexapi.io/x/articles/string/cover",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "cookie": "string",
  "cover_image": "string"
},
)

レスポンス例

{
  "code": 0,
  "msg": "string",
  "data": {
    "media_id": "string"
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "code": 429,
  "msg": "Daily tweet limit reached, please try again tomorrow."
}

{
  "code": 500,
  "msg": "Internal server error"
}