app.chronosky.schedule.listPosts

chronosky.app

Documentation

List scheduled posts for the authenticated user with pagination and filtering.

main query

List scheduled posts for the authenticated user with pagination and filtering.

Parameters

limit integer Optional

Number of parent posts per page. Thread posts always include all children regardless of limit (e.g., limit=100 returns up to 100 parent posts plus all their children).

page integer Optional

Page number (1-indexed).

status string Optional

Filter by post status.

Output

Encodingapplication/json
pagination ref#pagination Required

No description available.

posts array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Number of parent posts per page. Thread posts always include all children regardless of limit (e.g., limit=100 returns up to 100 parent posts plus all their children).
Page number (1-indexed).
Filter by post status.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "posts",
        "pagination"
      ],
      "properties": {
        "posts": {
          "type": "array",
          "items": {
            "ref": "#scheduledPost",
            "type": "ref"
          }
        },
        "pagination": {
          "ref": "#pagination",
          "type": "ref"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "page": {
        "type": "integer",
        "default": 1,
        "minimum": 1,
        "description": "Page number (1-indexed)."
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "Number of parent posts per page. Thread posts always include all children regardless of limit (e.g., limit=100 returns up to 100 parent posts plus all their children)."
      },
      "status": {
        "enum": [
          "PENDING",
          "EXECUTING",
          "COMPLETED",
          "FAILED",
          "CANCELLED"
        ],
        "type": "string",
        "maxLength": 20,
        "description": "Filter by post status."
      }
    }
  },
  "description": "List scheduled posts for the authenticated user with pagination and filtering."
}
pagination object

Pagination information.

Properties

limit integer Required

Posts per page.

minimum: 1
page integer Required

Current page number.

minimum: 1
total integer Required

Total number of posts.

minimum: 0
totalPages integer Required

Total number of pages.

minimum: 0
View raw schema 
{
  "type": "object",
  "required": [
    "page",
    "limit",
    "total",
    "totalPages"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Current page number."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Posts per page."
    },
    "total": {
      "type": "integer",
      "minimum": 0,
      "description": "Total number of posts."
    },
    "totalPages": {
      "type": "integer",
      "minimum": 0,
      "description": "Total number of pages."
    }
  },
  "description": "Pagination information."
}
scheduledPost object

Scheduled post object with AT Protocol standard fields.

Properties

atRkey string Optional

AT Protocol record key. Present after successful execution.

maxLength: 100 bytes
atUri string Optional

AT Protocol post URI (at://did:plc:.../app.bsky.feed.post/...). Present after successful execution.

maxLength: 500 bytes
children array of ref#scheduledPost Optional

Child posts in thread. Only present for parent posts with children.

createdAt string datetime Required

Post creation datetime (ISO 8601).

maxLength: 100 bytes
errorMsg string Optional

Error message if execution failed. Present only when status is FAILED.

maxLength: 2000 bytes
executedAt string datetime Optional

Execution completion datetime (ISO 8601). Present only when status is COMPLETED or FAILED.

maxLength: 100 bytes
facets array of refapp.bsky.richtext.facet Optional

Rich text facets for mentions, links, and hashtags (app.bsky.richtext.facet).

id string Required

Post ID.

maxLength: 100 bytes
langs array of stringlanguage Required

Language codes for post content (app.bsky.feed.post#langs). ISO 639-1 or 639-3 codes.

maxLength: 3 items
parentPostId string Optional

Parent post ID for thread posts. Null for root posts.

maxLength: 100 bytes
postgateCid string Optional

CID for postgate record. Present after successful execution with postgate settings.

maxLength: 100 bytes
postgateDisableEmbedding boolean Optional

Whether to disable quote posts and embeds for this post (app.bsky.feed.postgate).

postgateUri string Optional

AT Protocol URI for postgate record. Present after successful execution with postgate settings.

maxLength: 500 bytes
retryCount integer Required

Number of execution retry attempts.

minimum: 0
scheduledAt string datetime Required

Scheduled publication datetime (ISO 8601).

maxLength: 100 bytes
status string Required

Post status.

maxLength: 20 bytes
text string Required

Post content text (app.bsky.feed.post#text). May be empty if embeds are present.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
threadDepth integer Optional

Thread depth level (0 for root post, 1 for direct reply, etc.).

minimum: 0
threadPosition integer Optional

Position in thread (0-indexed). 0 for parent post, 1+ for children.

minimum: 0
threadgateCid string Optional

CID for threadgate record. Present after successful execution with threadgate rules.

maxLength: 100 bytes
threadgateUri string Optional

AT Protocol URI for threadgate record. Present after successful execution with threadgate rules.

maxLength: 500 bytes
updatedAt string datetime Required

Post last update datetime (ISO 8601).

maxLength: 100 bytes
userId string Required

User ID who created this post.

maxLength: 200 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "id",
    "userId",
    "text",
    "scheduledAt",
    "status",
    "createdAt",
    "updatedAt",
    "retryCount",
    "langs"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "description": "Post ID."
    },
    "text": {
      "type": "string",
      "maxLength": 3000,
      "description": "Post content text (app.bsky.feed.post#text). May be empty if embeds are present.",
      "maxGraphemes": 300
    },
    "atUri": {
      "type": "string",
      "maxLength": 500,
      "description": "AT Protocol post URI (at://did:plc:.../app.bsky.feed.post/...). Present after successful execution."
    },
    "embed": {
      "refs": [
        "app.bsky.embed.images",
        "app.bsky.embed.external",
        "app.bsky.embed.record",
        "app.bsky.embed.video",
        "app.bsky.embed.recordWithMedia"
      ],
      "type": "union",
      "description": "Embedded content such as images, external links, or quoted posts (app.bsky.embed.*)."
    },
    "langs": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "language"
      },
      "maxLength": 3,
      "description": "Language codes for post content (app.bsky.feed.post#langs). ISO 639-1 or 639-3 codes."
    },
    "atRkey": {
      "type": "string",
      "maxLength": 100,
      "description": "AT Protocol record key. Present after successful execution."
    },
    "facets": {
      "type": "array",
      "items": {
        "ref": "app.bsky.richtext.facet",
        "type": "ref"
      },
      "description": "Rich text facets for mentions, links, and hashtags (app.bsky.richtext.facet)."
    },
    "labels": {
      "ref": "com.atproto.label.defs#selfLabels",
      "type": "ref",
      "description": "Self-applied content labels for content warnings (AT Protocol standard)."
    },
    "status": {
      "enum": [
        "PENDING",
        "EXECUTING",
        "COMPLETED",
        "FAILED",
        "CANCELLED"
      ],
      "type": "string",
      "maxLength": 20,
      "description": "Post status."
    },
    "userId": {
      "type": "string",
      "maxLength": 200,
      "description": "User ID who created this post."
    },
    "children": {
      "type": "array",
      "items": {
        "ref": "#scheduledPost",
        "type": "ref"
      },
      "description": "Child posts in thread. Only present for parent posts with children."
    },
    "errorMsg": {
      "type": "string",
      "maxLength": 2000,
      "description": "Error message if execution failed. Present only when status is FAILED."
    },
    "createdAt": {
      "type": "string",
      "format": "datetime",
      "maxLength": 100,
      "description": "Post creation datetime (ISO 8601)."
    },
    "updatedAt": {
      "type": "string",
      "format": "datetime",
      "maxLength": 100,
      "description": "Post last update datetime (ISO 8601)."
    },
    "executedAt": {
      "type": "string",
      "format": "datetime",
      "maxLength": 100,
      "description": "Execution completion datetime (ISO 8601). Present only when status is COMPLETED or FAILED."
    },
    "retryCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of execution retry attempts."
    },
    "postgateCid": {
      "type": "string",
      "maxLength": 100,
      "description": "CID for postgate record. Present after successful execution with postgate settings."
    },
    "postgateUri": {
      "type": "string",
      "maxLength": 500,
      "description": "AT Protocol URI for postgate record. Present after successful execution with postgate settings."
    },
    "scheduledAt": {
      "type": "string",
      "format": "datetime",
      "maxLength": 100,
      "description": "Scheduled publication datetime (ISO 8601)."
    },
    "threadDepth": {
      "type": "integer",
      "minimum": 0,
      "description": "Thread depth level (0 for root post, 1 for direct reply, etc.)."
    },
    "parentPostId": {
      "type": "string",
      "maxLength": 100,
      "description": "Parent post ID for thread posts. Null for root posts."
    },
    "threadgateCid": {
      "type": "string",
      "maxLength": 100,
      "description": "CID for threadgate record. Present after successful execution with threadgate rules."
    },
    "threadgateUri": {
      "type": "string",
      "maxLength": 500,
      "description": "AT Protocol URI for threadgate record. Present after successful execution with threadgate rules."
    },
    "threadPosition": {
      "type": "integer",
      "minimum": 0,
      "description": "Position in thread (0-indexed). 0 for parent post, 1+ for children."
    },
    "threadgateRules": {
      "type": "array",
      "items": {
        "refs": [
          "app.bsky.feed.threadgate#mentionRule",
          "app.bsky.feed.threadgate#followerRule",
          "app.bsky.feed.threadgate#followingRule",
          "app.bsky.feed.threadgate#listRule"
        ],
        "type": "union"
      },
      "maxLength": 5,
      "description": "Reply restriction rules (app.bsky.feed.threadgate). Defines who can reply to this post."
    },
    "postgateDisableEmbedding": {
      "type": "boolean",
      "description": "Whether to disable quote posts and embeds for this post (app.bsky.feed.postgate)."
    }
  },
  "description": "Scheduled post object with AT Protocol standard fields."
}

Lexicon Garden

@