oysters.pubOpen oyste.rs

pub.oysters.getActorPosts

One account's submissions, most recently indexed first.

One account's submissions, most recently indexed first.

Parameters

fieldtypeabout
actorrequiredstring<at-identifier>

A DID, or a handle to resolve.

limitinteger

How many submissions to return.

min 1max 100default 25
cursorstring

Opaque. Pass back what the previous page returned.

Output · application/json

fieldtypeabout
cursorstring

Pass to the next call. Absent when there is nothing more.

feedrequireddefs#postView[]

The page, newest first.

Errors

NotFound

No account here by that DID or handle. An account this board has never seen is not an error the caller can fix, but it is still not found.

InvalidRequest

The actor is neither a DID nor a resolvable handle.

Raw document
{
  "lexicon": 1,
  "id": "pub.oysters.getActorPosts",
  "defs": {
    "main": {
      "type": "query",
      "description": "One account's submissions, most recently indexed first.",
      "parameters": {
        "type": "params",
        "required": [
          "actor"
        ],
        "properties": {
          "actor": {
            "type": "string",
            "format": "at-identifier",
            "description": "A DID, or a handle to resolve."
          },
          "limit": {
            "type": "integer",
            "description": "How many submissions to return.",
            "minimum": 1,
            "maximum": 100,
            "default": 25
          },
          "cursor": {
            "type": "string",
            "description": "Opaque. Pass back what the previous page returned."
          }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "feed"
          ],
          "properties": {
            "cursor": {
              "type": "string",
              "description": "Pass to the next call. Absent when there is nothing more."
            },
            "feed": {
              "type": "array",
              "description": "The page, newest first.",
              "items": {
                "type": "ref",
                "ref": "pub.oysters.defs#postView"
              }
            }
          }
        }
      },
      "errors": [
        {
          "name": "NotFound",
          "description": "No account here by that DID or handle. An account this board has never seen is not an error the caller can fix, but it is still not found."
        },
        {
          "name": "InvalidRequest",
          "description": "The actor is neither a DID nor a resolvable handle."
        }
      ]
    }
  }
}