Account

Sort Notes

Changed on

Sort a user's unsorted notes into proposed changes to a world: new elements, text to add, links to make, and questions where the notes are ambiguous. Body: world_id, notes (a list of notes: text, or a photographed note uploaded to this world's media, with optional text) and slice (the elements the client's own search found for them: id, type, name and an optional anchor, a short phrase that tells two same-named elements apart). The answer only proposes; the client applies what the user accepts. A sort spends its tokens from the account's daily token rating, as ask does. An account credential (Bearer ow_a_, a signed-in session, or a phone's X-Session-Token).

post/api/v2/account/sort

Request

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

Request body

world_idstring uuid required

A world this account owns or is a member of.

Response

The proposed changes: rows, each one of four kinds (make a new element; add_to text appended to a field of a slice element; link one slice element to another through a field; ask a question with candidates when a name matches several slice elements or the sorter is unsure, and optionally then, the add_to or link row it stands for without its target), each with the source_line it came from; not_proposed (lines not placed, each with a reason); model, stop_reason, usage {input_tokens, output_tokens}, remaining (how many more calls of this one's size fit in what this account has left today), tokens_remaining (the account's tokens left today after this call) and token_rating (the account's daily token rating). Every id in a row is an id from the request's slice; a row naming any other id is moved to not_proposed. Names, types and anchors of the elements a row points at are the slice's own. Nothing is written to the world.

modelstring required
stop_reasonstring required
remaininginteger required

How many more calls of this one's size fit in what this account has left today.

tokens_remaininginteger required

The account's tokens left today after this call.

token_ratinginteger required

The account's daily token rating.

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