Files API, gRPC: FileService.Create
Create a new file.
gRPC request
rpc Create (CreateFileRequest) returns (File)
CreateFileRequest
{
"folder_id": "string",
"name": "string",
"description": "string",
"mime_type": "string",
"content": "bytes",
"labels": "map<string, string>",
"expiration_config": {
"expiration_policy": "ExpirationPolicy",
"ttl_days": "int64"
}
}
Request message for creating a new file.
|
Field |
Description |
|
folder_id |
string Required field. |
|
name |
string Name of the file. |
|
description |
string Description of the file. |
|
mime_type |
string MIME type of the file, indicating the file's format (e.g., "application/pdf"). |
|
content |
bytes Required field. Binary content of the file. |
|
labels |
object (map<string, string>) Set of key-value pairs to label the file. |
|
expiration_config |
Expiration configuration for the file. |
ExpirationConfig
|
Field |
Description |
|
expiration_policy |
enum ExpirationPolicy
|
|
ttl_days |
int64 |
File
{
"id": "string",
"folder_id": "string",
"name": "string",
"description": "string",
"mime_type": "string",
"created_by": "string",
"created_at": "google.protobuf.Timestamp",
"updated_by": "string",
"updated_at": "google.protobuf.Timestamp",
"expiration_config": {
"expiration_policy": "ExpirationPolicy",
"ttl_days": "int64"
},
"expires_at": "google.protobuf.Timestamp",
"labels": "map<string, string>"
}
|
Field |
Description |
|
id |
string Unique identifier of the file. |
|
folder_id |
string ID of the folder that the file belongs to. |
|
name |
string Name of the file. |
|
description |
string Description of the file. |
|
mime_type |
string MIME type of the file, indicating the file's format (e.g., "application/pdf") |
|
created_by |
string Identifier of the subject who created this file. |
|
created_at |
Timestamp representing when the file was created. |
|
updated_by |
string Identifier of the subject who last updated this file. |
|
updated_at |
Timestamp representing the last time this file was updated. |
|
expiration_config |
Configuration for the expiration of the file, defining when and how the file will expire. |
|
expires_at |
Timestamp representing when the file will expire. |
|
labels |
object (map<string, string>) Set of key-value pairs that can be used to organize and categorize the file. |
ExpirationConfig
|
Field |
Description |
|
expiration_policy |
enum ExpirationPolicy
|
|
ttl_days |
int64 |