Sign in
vals

Update a file's content

put/v2/vals/{val_id}/files

Path parameters

val_idstring uuid required

Id of a val

Query parameters

branch_idstring uuid

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

pathstring required

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

Request body

contentstring

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

type'file' | 'interval' | 'http' | 'email' | 'script'
parent_pathstring nullable

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

namestring

Response

A File or Directory's Metadata

namestring required
idstring uuid required

The id of the resource

pathstring required
versioninteger required
updatedAtstring date-time required
type'directory' | 'file' | 'interval' | 'http' | 'email' | 'script' required

Changes

Changed in 6 of the 46 revisions of this API.554

  • 8f22304950dd1See the full diff
    • ▲

      request body became required

      request-body-became-required

  • 7ca4c991c6cc3See the full diff
    • ▲

      the / request property type changed from string to no type

      request-property-type-changed

    • ▲

      the response's property type changed from string to no type for status

      response-property-type-changed

    • ▲

      the response's property type changed from string to no type for status

      response-property-type-changed

  • dc1b3c9e3b2a141See the full diff
    • ▲

      the request's body type changed from object to no type

      request-body-type-changed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ○

      added subschema #1 to the request body anyOf list

      request-body-any-of-added

  • fb890bfd4bf71See the full diff
    • ●

      changed the pattern of the request property from ^[a-zA-Z0-9\-_.]+$ to ^[a-zA-Z0-9\$\[\]\(\)\-_.]+$

      request-property-pattern-changed

  • 05f618f5e1bc2See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • 1658025a57321See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog