remove_from_list

Remove a user from a list.

Authentication

Required: Yes (Private tool)

Parameters

listItemUri (required)

• Type: string
• Description: AT Protocol URI of the list item (from add_to_list)

Response

{
  success: boolean;
  message: string;
  deletedItem: {
    uri: string;
  }
}

Examples

Remove User from List

{
  "listItemUri": "at://did:plc:myuser/app.bsky.graph.listitem/item123"
}

Response:

{
  "success": true,
  "message": "User removed from list successfully",
  "deletedItem": {
    "uri": "at://did:plc:myuser/app.bsky.graph.listitem/item123"
  }
}

Error Handling

Common Errors

List Item Not Found

{
  "error": "List item not found",
  "code": "NOT_FOUND"
}

Invalid URI

{
  "error": "Invalid AT Protocol URI format",
  "code": "VALIDATION_ERROR"
}

Best Practices

• Store list item URI when adding users
• Handle "not found" gracefully
• Verify removal success
• Update UI immediately

Related Tools

• add_to_list - Add to list
• get_list - Get list details

See Also

• Social Operations Examples