PUT
/
v1
/
apps
/
{id}
/
files
Create or Update Application File or Folder
curl --request PUT \
  --url https://api.vertracloud.app/v1/apps/{id}/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "content": "<string>"
}'
{
  "status": "success"
}
id
string
required
The ID of the application to create or update the file or folder in. If the application belongs to an organization, include the organization ID in the format appId-orgId.
path
string
required
The path where the file or folder will be created or updated. End with / to create a folder.
content
string
The content of the file to create or update. Required for files, not applicable for folders.

Response

status
string
Indicates whether the call was successful. success if successful, error if not.
{
  "status": "success"
}

Error Responses

status
string
Indicates whether the call was successful. error if not successful.
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • FORBIDDEN: The user does not have permission to access the application.
  • APP_NOT_FOUND: The specified application does not exist.
  • PLAN_RESTRICTED_FEATURE: The user’s plan does not support file manager access (except for vertracloud.config).
  • MISSING_PATH: The path query parameter was not provided.
  • MISSING_CONTENT: The content body parameter is required for files.
  • INVALID_PATH: The provided path is invalid.
  • INVALID_CONFIG: The vertracloud.config file content is invalid.
  • INVALID_MEMORY: The requested memory in vertracloud.config is invalid or exceeds plan limits.
  • PUT_FILE_FAILED: Failed to create or update the file or folder.
  • OWNER_APP_WITHOUT_LIMITS: The owner’s plan limits could not be found.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}