list_posts

List posts

Read the social calendar. Pass exactly one of: post_id for one post; from and to (ISO times, at most 62 days apart) for every post scheduled in that range; drafts: true for the posts that have no time yet; or attention: true for posts with a failed account, posts still sending 15 minutes after their due time, and scheduled posts aimed at an account that needs reconnecting. A delayed post is still unconfirmed: do not resend it. With none, the next 14 days. A post to three accounts is one post with three targets, each with its own status and, once out, its public URL.

Scope

Behaviour

Read-only
Reads the caller's own account and changes nothing.
Stays in the account
Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
Idempotent
Calling it again with the same arguments has no further effect.

Inputs

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_posts",
    "arguments": {}
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "format": "uuid"
    },
    "from": {
      "type": "string",
      "format": "date-time"
    },
    "to": {
      "type": "string",
      "format": "date-time"
    },
    "drafts": {
      "type": "boolean",
      "const": true
    },
    "attention": {
      "type": "boolean",
      "const": true
    }
  },
  "additionalProperties": false
}

Related tools

Every tool· This page as Markdown