Sign in
LibraryService

CreateShelf

Creates a shelf, and returns the new Shelf.

post/v1/shelves

Request body

namestring required

The resource name of the shelf. Shelf names have the form shelves/{shelf_id}. The name is ignored when creating a shelf.

themestring

The theme of the shelf

next_sort_atstring date

The next sorting date.

created_atstring date-time

The creation date and time.

updated_atstring date-time

The last update date and time.

Response

OK

namestring required

The resource name of the shelf. Shelf names have the form shelves/{shelf_id}. The name is ignored when creating a shelf.

themestring

The theme of the shelf

next_sort_atstring date

The next sorting date.

created_atstring date-time

The creation date and time.

updated_atstring date-time

The last update date and time.

Changes

Changed in 6 of the 12 revisions of this API.77

  • v1ac9d37cae0e02See the full diff
    • ▲

      the request's body type/format changed from / to object/

      request-body-type-changed

    • ▲

      the response's body type/format changed from / to object/ for status 200

      response-body-type-changed

  • v1639a4ec995ca11See the full diff
    • ▲

      the request property name became required

      request-property-became-required

    • ○

      the response property name became required for the status 200

      response-property-became-required

  • v100e696b6b84a11See the full diff
    • ▲

      added the pattern ^shelves/[a-z2-7]{26}$ to the request property name

      request-property-pattern-added

    • ○

      the name response's property pattern ^shelves/[a-z2-7]{26}$ was added for the status 200

      response-property-pattern-added

  • v12a0f5e3b87341See the full diff
    • ○

      api operation id CreateShelf removed and replaced with LibraryService_CreateShelf

      api-operation-id-removed

  • v10dea6034d9691See the full diff
    • ○

      api operation id LibraryService_CreateShelf removed and replaced with CreateShelf

      api-operation-id-removed

  • v11f7e8ced536933See the full diff
    • ▲

      the request's body type/format changed from object/ to /

      request-body-type-changed

    • ▲

      the response's body type/format changed from object/ to / for status 200

      response-body-type-changed

    • ▲

      the response property name became optional for the status 200

      response-property-became-optional

    • ○

      the request property name became optional

      request-property-became-optional

    • ○

      removed the pattern ^shelves/[a-z2-7]{26}$ from the request property name

      request-property-pattern-removed

    • ○

      the name response's property pattern ^shelves/[a-z2-7]{26}$ was removed for the status 200

      response-property-pattern-removed

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