Account

Accept Link

Changed on

A signed-in account accepts a person join link (the code after # in an invite link) and becomes a member with the link's role. Body {"code": "ow_j_..."}. A phone's X-Session-Token is credential enough. Preview first with POST /api/v2/join/preview (no credential).

post/api/v2/account/join

Request

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

Request body

codestring required

The ow_j_ join code.

Response

Joined: the new membership (the same row as accepting an invite).

idstring uuid required

The membership.

world_idstring uuid required
world_namestring required
rolestring required
joined_atstring date-time required
roster_characterstring uuid nullable required

The member's Character in the world, or null.

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

    • 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 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

    • 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