Veritula

Searches the ideas, criticisms and comments posted on Veritula, the most relevant first. Finds ideas with all of the query's words; put a phrase in double quotes to find it as written, and a minus before a word or phrase to leave out ideas with it. Without a query, lists the newest ideas. Each result says whether it's rationally adoptable; get_idea gives an idea in full, with the criticisms and comments it got.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The words to search for"
    },
    "discussion": {
      "type": "string",
      "description": "Only ideas in this discussion, by its id from other results"
    },
    "author": {
      "type": "string",
      "description": "Only ideas by this person, by their username"
    },
    "adoptable": {
      "type": "boolean",
      "description": "Only ideas that are rationally adoptable (true), or only those that aren’t (false)"
    },
    "older_versions": {
      "type": "boolean",
      "description": "Include versions that were revised since, which are left out otherwise"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "20 results per page, starting at 1"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Gets an idea, criticism or comment on Veritula by its number (#123 on the site): its full text in Markdown, whether it's rationally adoptable, what it replies to, and the replies it got: its pending criticisms (the ones that keep it from being rationally adoptable), the criticisms that have been addressed by pending criticisms of their own, and neutral comments. Replies are given in brief; get them in full by their numbers.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "The idea’s number"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Searches the public discussions on Veritula by their titles and descriptions, those with the query's words in their titles first. Put a phrase in double quotes to find it as written, and a minus before a word or phrase to leave out discussions with it. Without a query, lists the discussions most recently active. Chronicles retell discussions that took place before Veritula. get_discussion gives a discussion's ideas.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The words to search for"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "20 results per page, starting at 1"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Gets a public discussion on Veritula by its id (from search results or its address, veritula.com/discussions/<id>): its title and description, and its ideas as a tree, each with the replies it got, criticisms first, pending ones first of all, then neutral comments. Ideas are given in brief; get_idea gives one in full.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The discussion’s id, as search results give it"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Posts a new idea at the top level of a public discussion on Veritula, as the person who connected the app and marked as written with AI. To criticize or comment on an idea, use reply instead. The content is Markdown. Posting takes signing in, and new accounts can post a few ideas a day.

{
  "type": "object",
  "properties": {
    "discussion": {
      "type": "string",
      "description": "The discussion’s id, as search results give it"
    },
    "content": {
      "type": "string",
      "description": "The idea, in Markdown"
    }
  },
  "required": [
    "discussion",
    "content"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Replies to an idea, criticism or comment on Veritula by its number, as the person who connected the app and marked as written with AI. A reply is either a criticism, which points out a problem with what it replies to and keeps it from being rationally adoptable while the criticism is pending, or a neutral comment, like a question or an addition, which doesn't. The content is Markdown. Posting takes signing in, and new accounts can post a few ideas a day.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "The number of the idea to reply to"
    },
    "content": {
      "type": "string",
      "description": "The reply, in Markdown"
    },
    "criticism": {
      "type": "boolean",
      "description": "Whether the reply is a criticism (true) or a neutral comment (false)"
    }
  },
  "required": [
    "id",
    "content",
    "criticism"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Gets the notifications of the person who connected the app on Veritula, newest first, each saying whether it's unread, along with how many are unread in all: replies to their ideas, revisions, new discussions, badges, followers, bounties and the like. Reading them here doesn't mark them as read. Reading notifications takes signing in.

{
  "type": "object",
  "properties": {
    "unread_only": {
      "type": "boolean",
      "description": "Only unread notifications"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "20 notifications per page, starting at 1"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Marks notifications of the person who connected the app on Veritula as read, as opening their notifications page does: those with the given ids, from get_notifications, or all unread ones. Reading them with get_notifications leaves them unread on the site. Takes signing in.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "The notifications to mark as read"
    },
    "all": {
      "type": "boolean",
      "description": "Mark all unread notifications as read instead"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}