File information update

line1

https://cn2us02.opapi.win

POST

/api/v1/user/files/update

Introduction

Update file information

Parameter description

Field name	Type	Required	Sample value	Comments
fileUniqueId	string	Yes	ENthMCy_5zr5zN3GRJseM	File UID Required
filename	string	yes	example-new.png	new filename required
purpose	integer	no	0	file purpose
is_public	boolean	no	true	Is it public
tags	array	No	["tag1", "tag2"]	New file Tag
expires_at	string	No	2024-12-31T23:59:59	Expiration time
unset_expires_at	boolean	No	false	Whether to unset the expiration time

Calling this interface requires providing valid APIKey credentials. If APIKey permission check is enabled, you need to have file-v1 permissions.

Attached:

File purpose purpose definition:

{
  COMMON = 0,
  FINETUNE = 1,
  CHAT = 2,
  LLM_TMP = 3,
  OPENAI_BATCH = 4,
  ANTHROPIC_BATCH = 5,
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://cn2us02.opapi.win/api/v1/user/files/update' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileUniqueId": "ENthMCy_5zr5zN3GRJseM",
    "filename": "new-pic.jpg",
    "purpose": "0",
    "is_public": true,
    "tags": [
        "t1",
        "t2"
    ],
    "expires_at": "2024-11-29T22:14:53+08:00",
    "unset_expires_at": false
}'

响应示例

{
    "statusCode": 200,
    "message": "File info updated successfully",
    "data": {
        "affectedRows": 1
    }
}

修改于 2025-10-15 08:07:30

File upload

Delete files

File information update

Introduction#

Parameter description#

请求参数

返回响应

Introduction

Parameter description