Account

Create World

Changed on

Body {name, pin?, key_name?}. An account without a PIN must send pin (1000-9999), which becomes its account PIN; an account with one must omit it (422). Returns the world and an ow_w_ key, shown once; key_name names that key.

post/api/v2/account/worlds

Request

  • Base URL: https://www.onlyworlds.com
  • URL: https://www.onlyworlds.com/api/v2/account/worlds
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Session-Token

Request body

namestring required

The world's name (not blank).

key_namestring nullable

A name for the world's write key, as the website's key list shows it (1 to 80 characters, not blank; trimmed). Omitted or null: the key has no name. The route makes exactly one key either way.

Response

Created: the world and its write key (shown once).

Changes

  • 78df39c4c62eRevision changes
    • warning

      added the new known_of_not_writable enum value to the / response property for the response status

    • warning

      added the new known_of_not_writable enum value to the / response property for the response status

    • warning

      added the new known_of_not_writable enum value to the / response property for the response status

    • warning

      added the new known_of_not_writable enum value to the / response property for the response status

  • 4dd5b1cd0687Revision changes
    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new character_taken enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status

    • warning

      added the new world_full enum value to the / response property for the response status