Zum Hauptinhalt springen
POST
/
files
/
v3
/
folders
/
update
/
async
フォルダープロパティーを更新
curl --request POST \
  --url https://api.hubapi.com/files/v3/folders/update/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "parentFolderId": 123,
  "name": "<string>",
  "id": "<string>"
}'
{
  "id": "57122e26-59f8-4cfc-ba53-96e30c816762",
  "links": [
    {
      "status": "https://api.hubspot.com/files/v3/folders/update/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status"
    }
  ]
}
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -Starter
この API には、次のいずれかのスコープが必要です。
files

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
id
string
required

更新するフォルダーの固有ID。

​
parentFolderId
integer

新しい親フォルダーのID。フォルダーとその子を指定されたフォルダーに移動します。

​
name
string

フォルダーの新しい名前。これにより、フォルダーのfullPathおよび全ての子も更新されます。

Response

accepted

Information on the task that has been started, and where to check it's status.

​
links
object
required

タスクに関連する情報をチェックする場所のリンク。「status」リンクにより、タスクのステータスを確認する場所のURLが指定されます。

Example:

"[{\"status\":\"https://api.hubspot.com/files/v3/folders/update/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status\"}]"

​
id
string
required

タスクのID

Example:

"57122e26-59f8-4cfc-ba53-96e30c816762"

⌘I