vals

Changed on

Create a new val

post/v2/vals

Request

  • Base URL
    https://api.val.town
  • URL
    https://api.val.town/v2/vals
  • Auth
    none declared

Request body

namestring required
descriptionstring
privacy'public' | 'unlisted' | 'private' required
orgIdstring uuid

ID of the org to create the val in

Response

A Val

namestring required
idstring uuid required

The id of the val

createdAtstring date-time required
privacy'public' | 'unlisted' | 'private' required

This resource's privacy setting. Unlisted resources do not appear on profile pages or elsewhere, but you can link to them.

imageUrlstring nullable required

The URL of this val's image

descriptionstring nullable required

Changes

  • 4d8b6d2e6db3Revision changes
    • warning

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

  • 7ca4c991c6ccRevision changes
    • breaking

      the request property type changed from string to no type

    • breaking

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