Update

put/v2/vals/{val_id}/files

Update a file's content

Path Parameters

val_idstring

formatuuid

Query Parameters

pathstring

Path to a file or directory (e.g. 'dir/subdir/file.ts'). Pass in an empty string to represent the root directory.

branch_idstring

optional

The specified branch of the resource. Defaults to main if not provided.

formatuuid

Body Parameters

contentstring

optional

File and val content. An empty string will create an empty file. When creating a directory, the content should be null or undefined.

minLength0

maxLength80000

namestring

optional

minLength1

maxLength48

parent_pathstring

optional

Path to the directory you'd like to move this file to (e.g. 'folder1/folder2')

typeenum

optional

"file" OR "interval" OR "http" OR 2 more

Hide ParametersShow Parameters

"file"

"interval"

"http"

"email"

"script"

Returns

idstring

The id of the resource

formatuuid

linksobject

Hide ParametersShow Parameters

htmlstring

The URL of this resource on Val Town

formaturi

modulestring

The URL of this resource's source code as a module

formaturi

selfstring

The URL of this resource on this API

formaturi

endpointstring

optional

This resource's web endpoint, where it serves a website or API

formaturi

namestring

pathstring

typeenum

"directory" OR "file" OR "interval" OR 3 more

Hide ParametersShow Parameters

"directory"

"file"

"interval"

"http"

"email"

"script"

updatedAtstring

formatdate-time

versionnumber

minimum0

curl https://api.val.town/v2/vals/$VAL_ID/files \
    -X PUT \
    -H 'Content-Type: application/json' \
    -d '{}'

200 Example

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "links": {
    "html": "https://example.com",
    "module": "https://example.com",
    "self": "https://example.com",
    "endpoint": "https://example.com"
  },
  "name": "name",
  "path": "path",
  "type": "directory",
  "updatedAt": "2019-12-27T18:11:19.117Z",
  "version": 0
}