social.colibri.beta.thread.repoint

colibri.social

Documentation

Moves a thread to another channel by rewriting the channel its record links to, and optionally repoints it at another message. Who may read the thread follows the new channel. Left without an anchor the thread keeps the one it has, so its marker sits wherever that message now lives.

main procedure

Moves a thread to another channel by rewriting the channel its record links to, and optionally repoints it at another message. Who may read the thread follows the new channel. Left without an anchor the thread keeps the one it has, so its marker sits wherever that message now lives.

Input

Encodingapplication/json
anchor refsocial.colibri.beta.defs#spaceRecordRef Optional

The message the thread should hang under, for a thread whose anchor was moved. It has to sit in the destination channel, and may be a message the AppView has not indexed yet. Absent keeps the anchor as it is.

channel stringspace-ref Required

The text channel to move it to.

thread stringspace-ref Required

The thread to move.

Output

Encodingapplication/json

Errors

AuthRequired The request has no valid service auth.
Forbidden The requesting user lacks the thread.manage permission and did not write both the thread's current anchor and the message it is being repointed at.
ThreadNotFound No thread matches the given space reference.
ChannelNotFound No channel matches the given space reference.
InvalidRequest The destination channel belongs to another community, is not a text channel, or is the channel the thread is already in while no new anchor was given.
CredentialsUnavailable The AppView cannot act as the community because its stored credentials are missing or unusable.
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://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "description": "Moves a thread to another channel by rewriting the channel its record links to, and optionally repoints it at another message. Who may read the thread follows the new channel. Left without an anchor the thread keeps the one it has, so its marker sits wherever that message now lives.",
  "errors": [
    {
      "description": "The request has no valid service auth.",
      "name": "AuthRequired"
    },
    {
      "description": "The requesting user lacks the thread.manage permission and did not write both the thread's current anchor and the message it is being repointed at.",
      "name": "Forbidden"
    },
    {
      "description": "No thread matches the given space reference.",
      "name": "ThreadNotFound"
    },
    {
      "description": "No channel matches the given space reference.",
      "name": "ChannelNotFound"
    },
    {
      "description": "The destination channel belongs to another community, is not a text channel, or is the channel the thread is already in while no new anchor was given.",
      "name": "InvalidRequest"
    },
    {
      "description": "The AppView cannot act as the community because its stored credentials are missing or unusable.",
      "name": "CredentialsUnavailable"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "anchor": {
          "description": "The message the thread should hang under, for a thread whose anchor was moved. It has to sit in the destination channel, and may be a message the AppView has not indexed yet. Absent keeps the anchor as it is.",
          "ref": "social.colibri.beta.defs#spaceRecordRef",
          "type": "ref"
        },
        "channel": {
          "description": "The text channel to move it to.",
          "format": "space-ref",
          "type": "string"
        },
        "thread": {
          "description": "The thread to move.",
          "format": "space-ref",
          "type": "string"
        }
      },
      "required": [
        "thread",
        "channel"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "thread": {
          "description": "The thread, after the move.",
          "ref": "social.colibri.beta.thread.defs#threadView",
          "type": "ref"
        }
      },
      "required": [
        "thread"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@