Sign in
vals

Create a new val

post/v2/vals

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

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

  • 4d8b6d2e6db31See the full diff
    • ●

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

      request-property-pattern-changed

  • 7ca4c991c6cc2See the full diff
    • ▲

      the privacy request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the privacy response's property type/format changed from string/ to / for status 201

      response-property-type-changed

  • db013824dc131See the full diff
    • ○

      added the new optional request property orgId

      new-optional-request-property

  • 2fa9b43f52251See the full diff
    • ○

      added the required property author/type to the response with the 201 status

      response-required-property-added

  • 137af5a9771c1See the full diff
    • ○

      added the required property imageUrl to the response with the 201 status

      response-required-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